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(57) Abstract 

A workflow management system which performs eight key functions: i) notifies the user that he or she has a step to begin or to 
complete (Nantes/Routings); ii) provides the user with the proper tools to complete a task (Transaction Manager); iii) provides the user with 
the proper information to complete a task (Workflow Server); iv) allows the user to see where a task fits in the overall process (Schedule); 
v) manages the proper reminders, alerts, and follow-ups to keep the process moving (Transaction Manager); vi) •*nr ma ^ certain standard 
procedures: vii) integrates with the organization's existing business systems; and viii) provides simple application program interfaces that 
allow developers to develop new custom applications that are workflow-enabled (Workflow Updater). 
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METHOD AND APPARATUS FOR MANAGING BUSINESS PROCESSES 



BRIEF SUMMARY OF TEE INVENTION 

Businesses are demanding new systems that directly 
support the management of business processes, systems 
that bring order and coordination to the flow of work. 
They are seeking to automate that part of office work 
that has been impervious to conventional data processing 
and information processing systems / which were not 
designed for business process management and are not 
well-suited to help with it . 

The present invention is a system for analyzing and 
structuring business processes that, when implemented in 
software, provides businesses with the tools they need to 
manage business processes efficiently and cost- 
effectively. 

The invention can be applied to all business 
processes from simple applications , such as intelligent 
forms routing, to sophisticated mission-critical 
enterprise-wide systems that integrate all marketing, 
production, and customer fulfillment processes. 

The resulting system enables users of the system to 
take coordinated action quickly and to manage processes 
painlessly. The results are increased productivity, 
reduced cycle time and hence , improved customer 
satisfaction. 

Workf low-enabled systems facilitate business 
processes. To do so, a workflow management system 
performs eight key functions: 

•Notifies the user that he or she has a step to 
begin or to complete. 

•Provides the user with the proper tools to 
complete a task. 
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•Provides the user with the proper information to 
complete a task. 

•Allows the user to see where a task fits in the 
overall process. 

•Manages the proper reminders, alerts, and follow- 
ups to keep the process moving. 

•Automates certain standard procedures . 

•Integrates with the organization's existing 
business systems. 

•Provides simple application program interfaces 
(APIs) that allow developers to develop new custom 
applications that are workf low-enabled. 

The workflow system's architecture is designed to 
fit within a variety of computer systems, collecting 
around itself not only specific applications, but also 
system enhancements and utilities from users and third- 
party developers. In addition, the architecture is 
designed to allow for interoperability among different 
applications and across diverse platforms. 

A fundamental concept of a workflow system is that 
any business process can be interpreted as a sequence of 
basic transactions called workflows. Every workflow has 
a customer, a performer, and conditions of satisfaction. 
The customer and performer are roles that participants 
can take in workflows. In addition, each workflow can 
have observers . 

In a workflow, the customer is the person for the 
sake of whom the work is done, either because they made a 
request or accepted an offer. It is customers who are 
responsible for evaluating performed work and determining 
whether this work meets their conditions of satisfaction. 
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The performer is the person who is responsible for 
completing the work and for declaring to the customer 
when the work is done. 

Requests and Offers are the two basic types of 
workflows. There are other workflow types such as 
Question, Inform and Note that are simplified derivations 
of Request and Offer. The conditions of satisfaction 
specify the work to be performed by the performer. In a 
request, the customer specifies the conditions of 
satisfaction, and in an offer the performer specifies 
them. (Then, of course, the two can enter into 
negotiation about the work to be done.) 

For example, given the sentence: 

"John asked Frank to prepare the report and deliver 

it by noon on Friday, " 
John is the customer for this workflow, Frank is the 
performer, and the conditions of satisfaction are 
"prepare the report and deliver it by noon on Friday." 
Further, because John asked for the report rather than 
Frank offering it, this workflow is of the type Request. 

Given the sentence: 

"John proposed to prepare the report and deliver it 

by noon on Friday for Frank, " 
John is the performer for this workflow, Frank is the 
customer, and the conditions of satisfaction are still 
"prepare the report and deliver it by noon on Friday." 
Further because John proposed the report rather than 
Frank asking for it, this workflow is of the type Offer. 

Observers of workflows take no direct action; they 
usually observe for management or training purposes. 

Business process maps display the workflows as 
loops, and display the relevant information about each 
workflow - the customer, the performer, the conditions of 
satisfaction and the cycle time. Figure 1 is a 
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business process map having a primary workflow 11 , 
conditional workflows 13 and 15, a conditional link 17, 
parallel workflows 19 and 21, serial workflows 23 and 25. 
In a workflow system according to the present invention, 
associated with each workflow are various parameters such 
as roles, cycle time, conditions of satisfaction or 
associate semantics to the links that imply automated 
action or provide the framework for application building, 
all of which are necessary to create a useful business 
process representation. Each workflow has four phases. 
The first phase is called the proposal phase during which 
a request is made of the prospective performer by a 
customer or an offer to a customer is made by a 
prospective performer. The second phase is called the 
agreement phase during which the offer is accepted by the 
customer or the request is agreed to by the performer and 
conditions of satisfaction are identified. Of course, 
during the agreement phase the original conditions of 
satisfaction can be negotiated by the customer and 
performer until an agreement is reached. The third phase 
is called the performance phase during which the 
performer undertakes to meet the agreed to or accepted 
conditions of satisfaction. When the performer believes 
that the conditions of satisfaction have been met, the 
performer declares completion. The last phase is the 
satisfaction phase during which the customer determines 
whether or not the conditions of satisfaction have been 
met by the performer, and if so f declares satisfaction. 

In U.S. Serial No. 600,144 filed October 17, 1990 
and U.S. Serial No. 07/368, 179 filed June 19, 1989, both 
owned by Action Technologies, Inc., the assignee of the 
present application, methods and systems for managing 
workflows, called conversations in the referenced 
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applications, are described. However, the teachings in 
the cited references are limited to single workflows with 
no capability for mapping business processes made up of a 
number of workflows linked together. In U.S. Serial No. 

filed January 15, 1993, a method and apparatus are 

disclosed for creating and modifying business process 
maps which is a desirable but not necessary component of 
the invented system. This component is referred to as 
the workflow analyst . 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is pictorial representation of a business 
process, i.e., a set of linked workflows. 

Figure 2 is a block overview diagram of a compiere 
workflow system. 

Figure 3 is pictorial representation showing the 
phases of a single workflow. 

Figure 4a is a transaction manager control flow 
when it detects the initiation of a new business process 
or workflow. 

Figure 4b is a transaction manager control flow 
when it detects a change in the transactions database 
that indicates that a user (or an agent) has taken an act 
in a workflow. 

Figure 4c is a transaction manager control flow 
when it processes the workflow events of a workflow. 

DETAILED DESCRIPTION OF THE INVENTION 
OVERVIEW 

The present invention is a method and apparatus 
which is used to enable application developers to 
generate workflow enabled applications that request 
services from the workflow server. These applications 
are used by users to act and participate in business 
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processes and enable managers to observe and query the 
status of workflows and business processes. 

Definitions 

In describing the invention, the following terms 
with their indicated definitions are used: 
Act 

Basic linguistic occurrence by which people 
intervene in moving a workflow towards completion. 
Agreement 

The outcome of the negotiation phase, in which two 
parties come to a common agreement of the 
conditions of satisfaction. 
Business Process 

A network of workflows linked together that 
represent the recurrent process by which an 
organization performs and completes work, delivers 
products and services and satisfies customers. 
Business Process Map 

This is a graphical representation of business 
process, which shows its workflows and their 
relationship. 
Primary workflow 

This is the first workflow which is initiated when 
a business process is initiated. Its condition of 
satisfaction represent the condition of 
satisfaction of the business process. 
Conditional Link 

A link that indicates that only one of a group of 
workflows will be triggered based on some 
condition . 
Conditions of Satisfaction 
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Conditions declared by or agreed to by a customer. 
The fulfillment of which is the purpose of a 
workflow. 
Customer 

The role in a workflow who makes a request or 
accepts and offer. 

Customer Satisfaction 

The objective of a workflow, the accomplishment of 
which is declared by the customer when the 
conditions of satisfaction in the workflow have 
been fulfilled. 

Cycle time 

A measure of the time from initiation to successful 
completion of a workflow phase f a complete workflow 
or a business process. 
Exception flow 

The path in the business process workflow map which 
is followed if a customer cancels or a performer 
revokes or declines. 

Link 

A defined dependency between two workflows and the 
mechanism by which dependencies between workflows 
is established . 

Loops (Workflow) 

A workflow is represented graphically by an 
elliptical loop with arrows shown in a clockwise 
direction wherein each quadrant of the ellipse 
signifies different phases of the workflow. 

Normal flow 

This is the path followed in a business process map 
when workflows complete with customer satisfaction. 
Observer 

A role in a workflow who cannot perform acts in the 
workflow, but is informed of acts in the workflow, 
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and has access to the information and data 
associated with the workflow. 

Offer 

The act by which the performer can initiate a 
workflow, specifying conditions of satisfaction 
that he is willing to satisfy for a customer. 

Organization roles 

Named positions in an organization who are 
authorized to make certain requests, agreements, 
take certain actions, set certain policies, and 
make certain decisions. The kind of roles will be 
accountant, office manager, etc. 

Performer 

One of the principal roles in a workflow: the role 
that commits to complete the conditions of 
satisfaction. 

Phase 

A characterization of the status of a workflow 
based on the acts that have happened and the acts 
that are permitted. Each workflow has four phases 
namely, the proposal phase the agreement phase, the 
performance phase and the satisfaction phase 
Request 

A customer does this act to initiate a workflow and 
declare conditions of satisfaction. 
Trigger 

An action in a workflow which causes an action in 
some other workflow. 
Triggered 

Action in a workflow based on certain 
conditions /status in some other workflow. 
Workflow 
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A structured set of acts between customers and 

performers organized to satisfy a customer's 

conditions of satisfaction. 
Workflow Activation 

A triggered action that enables the customer or 

performer of the workflow to take the initial act 

of the workflow. 
Workflow Initiation 

An act of request or offer initiates a workflow. 
Workflow Roles 

The association of participants in the workflows 

that take the acts in workflows; three roles are 

distinguished in workflows: customer, performer, 

and observer. 
Workflow Type 

This indicates whether the workflow is of request, 

offer or note type. 
Services Provided By A Workflow System 

The following describes the services provided by a 
workflow system. These services are provided to 
applications via calls to the workflow server APIs. These 
workflow server APIs provide the main mechanism to 
interface and get access to the services provided by the 
server. In an alternate embodiment, these services can 
be provided via updates to the workflow server databases 
rather than via calls to the workflow server APIs. 
Transact ions Services 

Transaction services are those related to 
initiating and acting in workflows by users and agents. 
These services are provided to workflow enabled 
applications via the transaction API. Alternatively, the 
services may be provided to workflow enabled applications 
through updates to the workflow transaction database. 
These services are also provided through the functions of 
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the workflow language specified in the definition of 
workflows . 

The services provided are as follows : 

a) Initiate a Workflow 

Through this function , an application requests the 
server to start a new workflow. For example , if a user 
fills an expense report form, when it is saved, the 
- resulting record or document represents the initiation of 
a workflow, the application will use this service to 
start the workflow. 

For example, in a workflow enabled application in 
the Lotus Notes environment (available from Lotus 
Corporation) , users initiate a new business process by 
composing a NOTES form in the transactions database. 
Users initiate workflows by editing and selecting options 
in forms. In other environments users fill in proper 
forms and the applications request the services via calls 
to the Transactions API. 

b) Act in a Workflow. 

Through this function, an application can take 
action /on <an existing workflow. For example, a manager's 
approval of an expense report indicates the fact the 
manager took an act in the workflow. 

c) Workflow status and available acts 
The workflow server updates and maintains the 

status of the workflow after each act is taken in a 
workflow. The server also updates the corresponding 
database records to reflect status and the available acts 
for the customer and performer such that users can see 
the workflow status and the available acts (given their 
role in the workflow) when they open the workflow 
transaction record of the transactions database or when 
they request such status from the server through one of 
the transactions API functions. 
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d) Bind and read process specific data (bound 
data) 

Through this function, an application binds 
application specific data to a workflow transaction. 
That is, this function allows applications to read and 
modify the process specific data (bound data) that the 
workflow server keeps in the workflow transaction 
document. The specification of the bound data (field 
names and their data types) are defined through 
definition services. This data is directly accessible to 
the application through transactions database forms. The 
server modifies the form specification to provide 
different display attributes of fields in forms depending 
on the status of a workflow. 

e) Workflows with pending actions 

Users can request to see a list of workflows with 
pending actions of the ongoing business process, given 
the role that the user has in the different workflows of 
the process. In the NOTES environment implementation, 
these lists are available through a set of views of the 
transaction database. 

f) Available Business Process 

These appear as a functional capability of a 
workflow enabled application. The workflow server reports 
the available business processes that a workflow enabled 
application can initiate . 
Definition Services 

Definition services are those related to defining 
the elements of a business process and its workflows and 
workflow links . 

a) Define a Business Process. 



Using the workflow application builder (or other 
design application that uses the workflow definitions API 
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which is the way the application builder interacts with 
the workflow server) , users can define the workflows and 
links that constitute. a business process. In this 
connection, references herein to the workflow application 
builder should be understood as a reference to any design 
application which defines the workflows, links, 
conditional links and workflow language scripts that 
constitute a business process. The details for accessing 
the services provided by the server so that a suitable 
design application can be constructed should be apparent 
to persons skilled in the art based upon the descriptions 
contained herein. 

b) Define a workflow. 

Using the workflow application builder (or other 
design application) , users can define the structure of 
particular workflows that belong to the business process 
being defined through a set of structure definitions 
(specification of records of the workflow definitions 
database) and enable the application builder (or other 
design application) to create, modify and delete 
definition documents in the database. 

Using the workflow application builder (or other 
design application), users can specify the: 

•business processes 

•links and workflows and all their elements 
•conditional links between workflows 
•bound data 

•follow-up and reminder specification 
•automated action to be taken by the server 

Names and Routing Services 

Names and routing services are those related to 
defining organizational roles and identities. The names 
and routing services allow an authorized user to create, 
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modify and delete names and routing records in the 
names/routing database. These records contain the 
organizational roles and identities of the organization 
serviced by the server. They also contain the routing 
information for each identity that allows the server to 
queue notifications and reports for the proper STF 
processor. These services are specified through the user 
interface of the application builder or other design 
application that uses the names/routings API of the 
workflow server. 

a) Define organization roles. 

Using the workflow application builder (or other 
design application) and a set of APIs from the workflow 
library, users can define roles used in the organization 
where the workflow system is implemented. 

b) Define identities. 

Using tiie workflow application builder (or other 
design application) and a set of workflow definitions 
APIs from the workflow library, users can define 
identities in the organization where the workflow system 
is implemented, 

STF Processing Services 

The STF processing services are provided by the 
server to STF processors (described below) through an STF 
queue database. The database contains records of pending 
notifications and reports to be given to specific users 
in applications that the STF processors service. STF 
processors process and delete these records once they are 
processed. 
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Configuration Services 

The configuration services are provided to the 
system administrator through a specific configuration 
database . Through a workflow server manager which is a 
user interface that uses the server administration API, 
the system administrator can define the network 
configuration of the system, the version of the servers, 
register STF processors, define the authorized users, 
specify the log database and the level of logging 
required. 

Scheduling Services 

The scheduling services allow an authorized user to 
create, modify and delete records of scheduled business 
processes. These records specify the date/time when the 
server must initiate a business process as well as the 
recurrence in which this initiation should happen. These 
services are specified through the user interface in the 
application builder. 

External Interfaces 

External interfaces provide services that are used 
by end-user applications, the workflow application 
builder, the workflow reporter and the STF processors. 
Some of these services, such as configuration services, 
are provided through specific user interfaces; others are 
provided by the workflow APIs . In an environment like 
NOTES (available from Lotus Corporation) , where the 
client interfaces interact with the databases directly, 
client workf low-enabled applications access the databases 
directly to obtain workflow services. They do not use a 
programmatic API; instead they read and write workflow 
structures that are interpreted by the workflow server. 
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In other environments workf low-enabled applications 
access the workflow services through the workflow APIs. 
Network Architecture 

The workflow server component of a workflow system 
is designed to be installed at a single site> managing a 
single set of databases. It can manage one or many 
business processes , and, as noted above, each business 
process can contain one or many workflows. 

The workflow server is configured through a 
configuration database. When the workflow server starts, 
it begins to monitor and update the workflow databases as 
appropriate. Each workflow server can monitor multiple 
definitions, transactions, or scheduling databases , as 
specified in the configuration database. 

In the NOTES environment distributed access to 
business process databases is achieved through the 
replication mechanisms of NOTES. 

The transactions database managed by the workflow 
server can be replicated through the standard mechanisms 
of NOTES . In this way, distributed access for viewing and 
changing business process status is achieved. 

A business process is designed in such a way that 
all the workflows that are part of the business process 
are stored and managed in a single NOTES (or other 
workflow enabled application) database. This database is 
then managed by a single workflow server for agent 
processing and workflow language interpretation. 

As a stand-alone server in the Microsoft Windows 
environment, a special version of the workflow server 
having a restricted functionality of services allows 
users of workf low-enabled applications to take action and 
move workflows to completion, but does not include the 
services of automated agents or of execution of workflow 
language scripts . 
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Components of a Workflow System 

A workflow system incorporates the following 
components which are shown in Figure 2, a workflow server 
and databases, application program interfaces (APIs) and 
workflow server manager. In addition, a complete 
workflow system of the type in which the present 
invention may be utilized includes an application 
builder, analyst, standard transaction format (STF) 
processors, workflow enabled applications and reporter 
components. The application builder, analyst, standard 
transaction format (STF) processors, workflow enabled 
applications and reporter components, while useful 
components of a complete workflow system, do not form 
part of the present invention and details concerning such 
components are set forth herein only as needed for an 
understanding of the invention. 

The following is a brief overview description of 
the workflow server, databases, APIs and workflow server 
manager which is followed by a detailed description of 
these components. Details concerning the remaining 
components are provided only as needed for a complete 
understanding of the invention. In the preferred 
embodiment as set forth below, the invented system is 
implemented using the Model , View, Class (MVC) paradigm 
of object oriented programming. 
Workflow Server 

The workflow server is the center of a workflow 
system. The workflow system concentrates workflow 
operations in the workflow server rather than in the end 
user applications. By using this client/server design, 
applications do not need to have the intelligence about 
workflows as part of their design. Application developers 
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can concentrate on their particular application 
development not having to worry about workflow logic and 
overhead because such functionality is handled at the 
server. 

Figure 2 shows the major components of the 
workflow server in relation to other components of a 
workflow system. These components are referred to as 
processes and modules . All work done by the server is 
performed by one of four processes which are referred to 
as the transaction manager, follow-up manager, date/time 
schedule manager and STF schedule manager. Processes are 
software components or tasks that are architected to run 
as separate entities from each other. The workflow server 
controls the four basic processes based upon workflow 
system server administration data in a configuration 
database in the following manner. First, it determines 
what STF processors need to run and spawns those 
processes. Second, it determines when to run the 
transaction manager and spawns that process. Third, it 
determines when to run the follow-up manager and spawns 
that process. 

These processes may be separate executables or 
simply separate tasks within the body of the workflow 
system server. 

Workflow server modules are software components 
that provide a specific type of functionality. Modules 
are used by the above processes and also among 
themselves . 

Organizationally the modules can be thought of as 
separate libraries. These modules are the workflow 
processor, workflow updater, the workflow instantiator, 
the workflow language interpreter, the workflow event 
handler, the agent actions manager, and the STF 
router/enqueuer manager. 
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Databases 

The workflow system utilizes the following 
databases : 

Definitions Database 

The definitions database contains records of the 
definitions of the organizations, business processes, 
workflows, roles, and acts. These records contain the 
instructions of what needs to be done in a workflow in a 
given instance. These records are used by the workflow 
updater and workflow processor to determine new workflow 
states and available actions. 

Transactions Database 

The transaction database contains records of the 
enactment of workflows. Each time a workflow is initiated 
or an, action taken within a workflow, a corresponding 
record is made in the transactions database. These 
records include the workflow instances, the action 
transactions, the current incompletions, and the 
relationships between different workflows. 

Name s / Rout ings Dat abas e 

The Names /Rout ings database contains records of the 
roles and identities of the organization where the 
workflow system is installed. It records the existing 
organizational roles, the current identities and the 
authorizations to act in one or more roles. 

Schedule Database 

The schedule database stores the date and time when 
a business process must be initiated. The date/time 
schedule manager reads this database . 

Administration/Configuration Database 
This database stores information needed by the 
workflow server to operate. 
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STF Queue Database 

This database stores the records of notifications 
to be sent to users that interact with the workflow 
system through an STF processor interface. 

Workflow APIs 

The workflow APIs provide a programming interface 
to access the services of the workflow server. Workflow 
enabled applications, STF processors (described below) 
and the application builder are all developed using these 
APIs. APIs of the invented system are as follows: 
transaction API, definitions API, reporter API, names and 
routings API, schedule API and administration API. 

Workflow Server Manager 

The workflow server manager is a component of the 
workflow system that provides a user interface for 
specific services of the workflow server such as: 

Server Management 

Authorization Maintenance 

Business Process Maintenance 

Workflow Maintenance 

STF Processor Maintenance 

Conf igur at ion 

Transaction Log Maintenance 

Business Process Scheduling and Organizational 
Calendar 

The WSM uses the workflow APIs to implement the 
functions and services it provides to users. Through the 
use of the WSM, a user selects the scheduling function 
which provides the user interface to specify the 
recurrent scheduling of business processes as well as the 
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specification of the organizational calendar as specified 
by the schedule manager. 
Workflow Application Builder 

The workflow application builder is a Graphical 
User Interface (GUI) application that allows a business 
process designer to specify the business process design 
with its network of workflows. The application builder, 
in turn, creates or edits the workflow definitions 
databases that define the business process and that will 
be used by the workflow server. The functions performed 
by the workflow application builder can alternatively be 
performed by a design application that uses the workflow 
definitions API of the workflow server. 
Workflow Analyst 

The workflow analyst is a GUI application that 
allows a business process analyst to specify the map of 
business processes with its network of workflows. Its 
output is readable by the application builder or 
equivalent which will update the definitions database of 
the server. Details concerning the workflow analyst may 

be found in co-pending U.S. Serial No. filed 

January 15 , 1993. 
Workflow Reporter 

The workflow reporter is a GUI application that 
provides an interface to the transaction databases 
through the workflow reporter API of the system. It 
allows the observation of the status of current 
transactions as well as the history and performance of 
past transactions. Further details concerning the 
workflow reporter are not needed for a complete 
understanding of the present invention. Alternatively, 
such reports can be provided by an application that uses 
the workflow reporter API. 
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STF Processors 

An additional set of mechanisms for developing 
workf low-enabled applications are provided in a workflow 
system through the definition of a standard transaction 
format (STF) . This format defines the semantics for 
accessing the workflow services through different types 
of interfaces: messaging, databases and inter-process 
communication. 

For each one of these types of interfaces there is 
a syntactic definition that specifies the specific format 
for the representation of the workflow data and the 
process specific data in that medium. This syntax 
definition constitutes an STF API that a particular 
application will then use. 

The communication and interface between workflow- 
enabled applications that do not use the workflow APIs 
and the server is provided by STF processors. These STF 
processors map and translate between a workf low-enabled 
application's data format and the workflow APIs data 
elements. 

STF processors provide a layer for integration of 
many different protocols and technologies . STF processors 
can be constructed for any message transport environment 
protocol, database technology, and inter-process 
communication protocol. 

The interface from STF processors to the server is 
accomplished through the workflow APIs. From the point of 
view of workflow services, the STF processors appear to 
the server as additional applications. 

A standard transaction format (STF) processor is an 
application whose job is to interface external systems to 
the workflow system. There is one STF processor for each 
different type of system that interfaces to the workflow 
system. 
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Workf low-Enabled Applications 

A workf low-enabled application interfaces to the 
server via the workflow APIs or via direct access to the 
transactions database of the workflow server, or via the 
use of an STF processor which can use different 
interfacing mechanisms such as messaging, database or 
inter-process communication . 
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DESIGN AND IMPLEMENTATION DESCRIPTION 
A. WORKFLOW SERVER 

The workflow server is a set of processes, modules/ 
databases and APIs as set forth above. The following is 
a description for implementing the processes, modules, 
databases and APIs of the workflow server. Also 
described is a workflow server manager which provides a 
user interface for specific services of the workflow 
server . 
Processes 

Transaction Manager (TM) 

The TM starts all the actions that must happen when 
there is a change in the transactions database. The TM 
is the driver for processing requests made by users 
through workf low-enabled applications. The transaction 
manager determines what changes in the transaction 
database have occurred. Records that have changed in the 
database are detected by the TM. The transaction manager 
manages a transaction queue and services queued 
transactions in FIFO order. Transactions may be entered 
directly by a user via forms available in workflow- 
enabled applications/ which use the workflow transactions 
APIs to request the services of the workflow server, or 
they may be requested via an STF Processor. 

A workflow record that has changed, falls into one 
of several different categories. It may be: 

A request for initiation of a new business process; 

A request for initiation of a new workflow within a 
business process; or 

A request for an act within a workflow. 

Each of the different types is dealt with 
differently . 

When there is a business process or workflow 
initiation 
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Figure 4a shows the control flow of the transaction 
manager when it detects the initiation of a new business 
process or workflow. In this case the transactions 
database will contain the record for the business process 
or the workflow being initiated. 

In Flow #1 the transaction manager detects the 
initiation of a business process or workflow in the 
transactions database. 

In Flow #2 the transaction manager calls the 
Instantiator Module, which will instantiate the workflow 
records based on the definition of the business process. 

In Flow #3 the instantiator reads the definition of 
the business process or workflow from the definitions 
database . 

In Flow #4 the Instantiator creates all the new 
transaction records for the corresponding workflow or the 
business process. 

Figure 4b shows the control flow of the 
transaction manager when it detects a change in the 
transactions database that indicates that a user (or an 
agent) has taken an act in a workflow. 

In Flow #1 the transaction manager detects the 
workflow act being taken in the transactions database. 

In Flow #2 the transaction manager calls the 
workflow updater to begin processing this newly updated 
transaction record. 

In Flow #3 the workflow processor calculates next 
available acts, new incompletions, etc. 

In Flow #4 the next available actions, 
incompletions, etc. are written to the transaction 
records . 

In Flow #5 the workflow updater checks the names 
database to see if one of the identities participating in 
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the workflow being processed needs to be notified via an 
STF processor. 

In Flow #6 if an identity has been identified in 
Flow #5 that needs to be notified via an STF processor, 
then the transaction is queued in the STF queue database. 

Figure 4c shows the control flow of the 
transaction manager when it processes the act and state 
events, which are also referred to herein as workflow 
events, of a workflow. In the definitions database, each 
workflow definition includes workflow language segments 
(scripts) that are associated with each act and stare of 
the workflow. 

In Flow #1 the transaction manager invokes the 
workflow event handler indicating the workflow, act and 
state that should be processed. 

In Flow #2 the workflow event handler reads the 
script for the act from the definitions database. 

In Flow #3 the workflow event handler invokes zhe 
workflow language interpreter to process the script. 

In Flow #4 If the script indicated that an action 
needs to be taken, the workflow language interpreter 
calls the agent actions manager to take the workflow act 
on behalf of the user. 

In Flow #5 the agent actions manager updates the 
transactions database to reflect that an act has been 
taken. 

The workflow event handler then repeats Flow #2, 
but in this case reads the script for the state of the 
workflow. The process continues to Flow #3 with respect 
to the state. 

The workflow event handler repeats Flow #2 and Flow 
#3 for the script that corresponds to the current state 
of the primary workflow of the business process. 
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In the preferred embodiment, the transaction 
manager is implemented as follows. The transaction 
manager identifies changes that have taken place in the 
workflow transaction database and invokes the proper 
server modules to provide the services that have been 
requested or that those changes represent. The 
transaction manager queues and services incoming 
transactions by instantiating a transaction-type-specific 
object. 

The date/time the transaction was entered is given 
along with its type and id. This date/time field is used 
to do FIFO (first in-firat out) queue retrievals. The 
earliest date/time will always be retrieved first. 

1TXID is the id of a transaction in the Transaction 
Database. These ids are txt.ypft dependent and can be used 
to access transactions directly from the database. 

The following is a description in pseudo-code for 
implementing the transaction manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 

MAIN 

The MAIN function connects to the Virtual 
Database (VDB) , performs the primary activity of the 
transaction manager and disconnects from the Virtual 
Database . 
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The primary activity of the transaction manager is 
checking the workflow transactions database for requests 
to process . It performs this primary activity by a call 
to the function MainLoop. 

In case of an error, the MAIN function performs a 
write to an error log, giving the error code and the 
message. The flow of the MAIN function is as follow: 

1. Connect to the Virtual Database. 

2. If connection is successful write a message to a log 
provided by the workflow server manager described 
below. 

3. If connection is not successful, write a message to 
the log and return. 

4. Call function MainLoop. 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write a message to the 
log 

7. If disconnection is not successful, write a message 
to the log and return. 

MainLoop 

This function performs the primary activity of the 
transaction manager. In an unconditional loop, it checks 
if any message has been sent from the workflow server 
manager (WSM) and processes it. It then performs the main 



„ •-*-*-> #- • f ^^t- mni r nc\ 



28 

WO 94/18620 FCT/US94/01287 

« _ 

activity of checking for workflow requests and invokes 
either the workflow updater or the agent/action manager. 

1. Check for any message for the transaction manager 
from the WSM. To retrieve messages, the method 
hfnftfrtM essage of class MESSAGEO is called. In case of 
any error, the error is written into the log file. 

2. Depending on the message, the message is processed 
differently, according to steps 3 and 4 below. 

3. If the message is to terminate the transaction 
manager, the function is terminated. 

4 . If the message is to indicate that the configuration 
has changed then do the following: 

5. The new configuration is retrieved using method 
hfnGftf.Conf liqlnfo of class CDNEIfilHEQ. The new 
configuration is returned in a structure that 
contains all the configuration information . In case 
of error in retrieving the configuration information, 
the error is written in the log file. 

6. The configuration database specifies the polling 
interval and the log verbosity options. The polling 
interval is the time the transaction manager sleeps 
between processing cycles. The log verbosity option 
specifies the amount of information that gets written 
into the log file. The function AWSWritgTnT.ng i s 
used to log activities into the log file, 

7. Invoke workflow updater. 
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8. Invoke the agent actions manager. 



9. Sleep for a time interval of duration Polllnterval . 

10. Proceed to step 1. 

Follow Up Manager 

The follow-up manager runs periodically, scheduled 
per workflow server administration tables in the 
administration/configuration database. It can run 
asychronously to the transaction manager. It determines 
when notifications, either follow up or reminders, are to 
be sent and sends them. 

The follow-up manager detects transactions in which 
a participant has an overdue commitment and, depending on 
the workflow definition stored in the definitions 
database, will execute a script, send a mail message, or 
take other actions that are defined. The follow-up 
manager interacts with a Workflow Incompletion 
Transaction class which is part of the transaction 
database, which furnishes follow up and reminder times, 
in order to select workflows requiring notification. 

Follow up is specified in the workflow definition. 
This specification is done through the application 
builder or equivalent . For each workflow, a follow up 
specification can be made for each one of the roles of 
the workflow as follows: 

Specify when the follow-up will be done 
First and last valid times 
Recurrence interval 

Holidays on which not to follow-up (Optional) 
Days of week on which to follow-up (Optional) 
Time ranges in which to follow-up (Optional) 
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How many times to follow-up before stopping 
Specify incompletions to be followed up on 

Customer response due 

Performer response due 

Performer fulfillment due 
Specify the type of check 

Will be coming due (reminder) and how soon 

Is past due (follow-up) by how much 
Specify what to do for the follow-up 

In each workflow transaction, the current 
incompletions for each role are kept as indexed records. 
In addition to the date for the incompletion, the record 
will contain a field for the next date and time for 
follow up as well as the next date and time for reminder. 
The records will be indexed on these two date fields as 
well. The follow-up manager works off these incompletion 
records . 

The follow-up manager checks if the first follow-up 
or reminder date/time is due "now" and that "now" is not 
a restricted date/time according to the organizational 
calendar, and if so, retrieves the workflow language 
script and passes it to the Workflow Language Interpreter 
for processing. The follow-up manager deals appropriately 
with the case that the server has been down and processes 
all entries that are past due. 

The following is a description in pseudo-code for 
implementing the follow-up manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 



MAIN 
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The MAIN function connects to the Virtual 
Database (VDB) , performs the primary activity of the 
follow-up manager and then disconnects from the VDB. 

The primary activity of the follow-up manager is 
checking for overdue commitments and then sending 
reminders or follow-up messages. It performs this primary 
activity by a call to the function MainLoop. 

In case of an error, the MAIN function performs a 
write to an error log, giving the error code and the 
message. The flow of the MAIN function is as fbllow: 

1. Connect to the Virtual Database. 

2. If connection is successful write a message to the 
log . 

3. If connection is not successful, write a message to 
the log and return. 

4. Call function MainLoop. 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write a message to the 
log 

7. If disconnection is not successful, write a message 
to the log and return. 

MainLoop 
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This function performs the primary activity of the 
follow-up manager. In an unconditional loop, it checks if 
any message has been sent from the workflow server 
manager (WSM) using the workflow administration API, and 
processes it. It then checks for commitments due and 
sends follow-up and reminder messages if required. The 
flow of MainLoop is as follows: 

1. Check for any message for the follow up manager from 
the (WSM) . To retrieve messages , the method 
bfnGetMessage of class MESSAGEQ is called. In case of 
any error, the error is written into the log file. 



2. Depending on the message, the message is processed 
differently, according to steps 3 and 4 below. 

3. If the message is to terminate the follow-up manager, 
the function is terminated. 

4. If the message is to indicate that the configuration 
has changed, then do the following: 

5. The new configuration is retrieved using method 
bfnGetConfiglnfo of class CONFIGINFO. The new 
configuration is returned in a structure that 
contains all configuration information. In case of 
error in retrieving the configuration information, 
the error is written to the log file. 

6. The configuration database specifies the polling 
interval and the log verbosity options . The polling 
interval is the time the follow-up manager sleep 
between processing cycles. The log verbosity option 
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specifies the amount of information that gets written 
into the log file. 

7. The function FollowUp is called to perform the main 
activity of the follow-up manager. 

8, Sleep for a time interval of duration Polllnterval . 



9. Proceed to step 1. 



FollowUp 

The FollowUp function scans the Incompletions table 
of the transactions database and determines which 
incompletions are due for reminder or follow-up. The 
processing is done in two passes, one for reminders and 
the other for follow-ups . 



1. Set a flag to indicate if it is a reminder or follow- 
up pass. 

2. Get the current time- This time will be the basis for 
selecting incompletions which are due. If the 
incompletions are prior to the current date then the 
incompletion is processed. In case of error in 
getting the current time, log an error and return. 

3. Using methods of class txwftncqmpletton from the 
transactions database, the incompletions due for 
processing are retrieved. Methods 

b f n Get F irst T ncomp 1 et. i on and hf nftfitNext Incnmplfit -I on 
retrieve the incompletions that are due. 
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4. If an incompletion is due (reminder or follow-up), 
methods of class TvwPTwrnMPT.RTTQN are called to get 
the Business Process Id MBPTidi . the Workflow Id 
( lWFTid i and the Incompletion type(lncld). The • 
following methods are used: 



Value 


Methods 


BPTid 


lfnGetBPTid 


WFTid 


lfnGet WFTid 


Incld 


fnGetlncId 



5. The workflow associated with the incompletion is 
retrieved from the VDB. An instance of the class 
txwf instance is created. The TBPTid and the IWFTid 
are passed as parameters. 



6. Depending on the incompletion, the workflow 

participant is determined. The logic for determining 
the workflow participant is as follows: 



Notification 
Type 


Incompletion 
Type 


Workflow 
Role 


Reminder 


Customer His Completion 


Performer 


Follow-uo 


Customer His Response 


Performer 


Follow-uo 


Customer His Completion 


Performer 


Follow-up 


Performer His Response 


Customer 



7. Check if the Identity needs notification. The 

Identity attributes are retrieved from the VDB. These 
are stored in table NPnrTnENTTTY . if the Notification 
flag is set then the follow-up/reminder information 
is sent to the workflow participant. The notification 
information is retrieved using method bfnGetNQtify ■ 



8. If notification is required, then retrieve the STF 
Processor Id, by using method 1 f nfifft-.STFProcld of 
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class ^ pTTTnPWTTTY . The notification is placed in the 
STF queue of this STF processor. 

9. The notification event is determined by the following 
table: 



Incompletion Tvpe 


Event Type 


Customer His 
Completion 


Performer Completion coming due 


Customer His Response 


Performer Response past due 


Customer His 
Completion 


Performer Completion past due 


Performer His 
Response 


Customer Response past due 



10. Get the time when the incompletion was due i.e. the 
Completion Time (this is not to be confused with the 
completion time of the workflow) . 

11. Get the reminder or follow-up time, i.e. the time 
this notification was due. (Note: It is important to 
distinguish between incompletion due time and 
reminder and follow-up due time) . 

12. Dispatch notification. The notification is placed 
in the STF Queue. Method bfnPut.Event of class 
txstfoueue places the notification. 

13. Determine when the next notification is to be sent. 
Get the workflow notification definition. This 
contains recurring information. The next follow-up 
time is determined and written to the incompletion 
table via method vf nPnr.Fol 1 owlTpTime . 



14. Get the next incompletion to be processed. If 
present, proceed to step 4. 
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15. Return, processing is complete. 

Date/Time Schedule Manager 

The date /time schedule manager detects events which 
are to be executed at a particular time. The scheduled 
events are kept in the schedule database. The events are 
placed in the database by the workflow server manager 
user interface via calls to the schedule API and are 
processed by the schedule manager. The scheduled events 
are kept in the database in chronologically increasing 
order . 

A schedule database entry specifies when the event 
will be done as well as the first and last valid times 
for the entry, indicating the first time it should happen 
and when it should stop happening. If the first and last 
valid times are the same, the schedule entry is executed 
once . 

A recurrence interval for a schedule entry is "how 
often" the schedule entry is executed. Recurrence 
intervals may be every X minutes, every hour, every day, 
every month, the third Thursday of every month, and so 
forth. 

An organizational calendar is connected to the 
schedule manager, so that entries may be tagged to not 
happen on specific days (such as weekends or holidays 
like Labor Day) . 

The schedule entry may be filtered to happen only 
on particular days of the week (such as Monday through 
Friday) . 

The schedule entry may be filtered to happen only 
during particular time intervals (such as any time 
between 8-12 or 1-5) 

The first thing that the schedule manager does in a 
cycle is to find events that are due now (or which are 
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past due) . This is done by finding those with a time-out 
time that is less than "now". 

For each of the found entries , the schedule manager 
then brings the time-out forward to "now", even if it is 
currently set in the past. This function should deal 
properly with the case when the server has been down . 

For each of the found entries, the schedule manager 
then passes the business process initiation script to the 
Workflow Language Interpreter for processing. 

After the schedule entry is processed, the schedule 
manager updates the schedule entry record for the next 
time out based on the parameter set for it. If the entry 
needs not be executed again, it is then removed from the 
schedule database . 

The following is a description in pseudo-code for 
implementing the schedule manager process. This 
implementation is described in terms of a MAIN function 
or routine which includes a call to a loop (MainLoop) 
which executes continuously. 

MAIN 

The MAIN function connects to the Virtual 
Database (VDB) , performs the primary activity of the 
Scheduler and disconnects from the Virtual Database. 

The primary. activity of the schedule manager is to 
find business processes that are scheduled for initiation 
and start them. 

In case of an error the MAIN function performs a 
write to an error log, giving the error code and the 
message. The flow of the MAIN function is as follow: 
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1. Connect to the Virtual Database. 

2. If connection is successful write an message to the 
log . 

3. If connection is not successful write a message to 
the log and return. 

4. Call function MainLoop. 

5. Disconnect from the Virtual Database. 

6. If disconnection is successful write an message to 
the log 

7. If disconnection is not successful, write a message 
to the log and return. 

MAINLOOP 

This function performs the primary activity of the 
schedule manager. In an unconditional loop, it checks if 
any message has been sent from the workflow server 
manager (WSM) using the workflow administration API, and 
processes it. It then performs the main activity of 
scheduling business processes at the scheduled time. 

1. Check for any message for the schedule manager from 
the WSM. To retrieve messages, the method 
bfnGet-Mgfisage of class MESSAGEO is called. In case of 
any error, the error is written into the log file. 
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2. Depending on the message, the message is processed 
differently, according to steps 3 and 4 below. 

3. If the message is to terminate the schedule manager, 
the function is terminated. 

4. If the message is to indicate that the configuration 
has changed then do the following: 

5. The new configuration is retrieved using method 
bfnSftt.Configlnfo of class conftgtnfo . The new 
configuration is returned in a structure that 
contains all configuration information. In case of 
error in retrieving the configuration information, 
the error is written in the log file. 

6. The configuration constitutes the polling interval 
and the log verbosity options. The polling interval 
is the time the Scheduler sleeps between processing 
cycles. The log verbosity option specifies the amount 
of information that get written into the log file. 

7. The function Scheduler is called, this performs the 
main activity of the schedule manager. 

8. Sleep for a time interval of duration Polllnterval . 

9. Proceed to step 1. 
Scheduler 

The Scheduler function scans the scheduler table of the 
schedule database and determines which business processes 
are ready to be scheduled. 



ci tocrrri itc cucct (R! II F ?6\ 



WO 94/18620 



40 



PCT/US94/01287 



1. Get the current time. This time will the basis for 
selecting business processes which are due to be 
started. If the initiate time of the business process 
is after the current date then the business process 
is initiated. 

2. Using methods of class SCBPSCHEDULE the business 
processes due for initiating are retrieved. Methods 
bfnGetFirstlncompletion and bfnGetNext Incompletion 
retrieve the business processes that are due. 

3. Get the Business Process Definition Id (BPDid) . Use 
method IfnGetBPDid of class SCBPSCHEDULE. 

4. Get the Business Process Definition. Create an 
instance of class DFBP for definition id BPDid. 

5. Get the Business Process Name. Use method 
vfnGetBPName of class DFBP. 

6. Initiate the business process. Transactions API call 
AWSTINITBP is called. The Business Process Name is a 
parameter to this call . 

7. Determine the next time the Business Process needs to 
be scheduled. The Recurring Offset is retrieved using 
methods IfnGetRecTime of class SCBPSCHEDULE. 

8 . If the Recurring Offset is specified, the next 
initiate time is computed by adding the recurring 
offset to the current initiate time. 
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9. If the Recurring Offset is not specified, the 
scheduling entry is deleted from the table. 

10. Get next Business Process to be initiated. If 
present, proceed to step 3. 

11. Return, processing is complete. 
Modules 

Workflow Processor 

The workflow processor is the jbrain of the workflow 
system. The workflow processor is analogous to the 
central processor unit (CPU) in a computer. Both 
processors receive inputs in the form of events, and both 
carry out logic computations . The CPU embodies a logic 
processor, while the workflow processor embodies the 
logic of workflows with phases, cycle times, actions and 
roles. It contains the structures and Finite State 
Machines (FSMs) that specify the acts and actions that 
are available. This module is database independent, and 
provides an API through which the rest of the system 
interfaces with it. It is furnished with in-memory 
structures providing complete act /state data of a 
workflow, from which it derives updated status 
information returned via these structures. The workflow 
processor embodies the logic of workflows with phases, 
actions, roles and dates of completion and reply. 

The basic logic of the workflow server is very 
similar to that used by a human manager. It asks: 

• What actions have happened and not happened? 

• What data has changed? and 

• What amount of time has elapsed? 
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The workflow updater module of the workflow server 
asks the workflow processor: 

• What are the available acts for the customer 
and performer given the current state and the 
type of the workflow? 

• Given an act, what is the new state of the 
workflow and what incompletions change? 

The workflow processor then answers with the state 
of the workflow and gives the answer to the workflow 
updater which updates databases, and changes the state of 
the workflow. 

These tasks would be impossibly complex if the 
number of states were large and the possible actions 
infinite. The present invention addresses this problem by 
defining a business model that intelligently defines a 
few conditions and actions as building blocks, but from 
which thousands of permutations can be constructed* 

A complete description of a suitable workflow 
processor which may be used in a workflow server may be 
found in U.S. Serial No. 600,144 filed October 17, 1990 
and U.S. Serial No. 07/368,179 filed June 19, 1989, both 
owned by Action Technologies, Inc., the assignee of the 
present application. 

Workflow Updater 

The workflow updater module processes requests made 
by users via API calls, changes to the transaction 
database or by agent actions. This module processes 
workflow transactions that have been modified, updating 
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them with the new workflow status information returned by 
the workflow processor . 

The workflow updater module updates the bound data 
in the business process , based on the data that was 
provided as part of the act that is being taken. If other 
scopes are defined for a workflow, then the bound data is 
updated in the scope of the workflow in which the act was 
taken . 

The workflow updater calls the workflow processor 
passing to it the workflow identification, the act being 
taken, the workflow role that is taking the act and the 
current state. The workflow processor returns to the 
workflow updater the new state of the workflow, feke 
incompletion transitions (what incompletions need to be 
set, and which ones need to be removed) , the set of 
available acts for each one of the workflow roles and the 
times that can/must be specified by the users when taking 
each one of these available acts. 

The workflow updater maintains and updates the 
workflow transaction database. It uses the workflow 
processor to determine the status of workflows and the 
set of possible actions for each one of the roles. 

The workflow updater processes an act taken by a 
workflow participant i.e., the Customer or Performer. 
This act could have been taken through a call to the 
proper transactions API function, through a direct 
modification of the transactions database or by the agent 
actions manager upon request of the workflow language 
interpreter. When an act is taken, it is recorded in a 
act taken database record of the transactions database. 
The server sequentially processes all acts. The following 
is a description in pseudo-code for implementing the 
workflow updater module. 
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1. Use awswrit-fiToLoa method of the Transloq class of the 
Administration database to log the act taking 
activity. 

2. Check whether there are acts to take by calling 
method hnnflfttFir stmoueue of class TxWFftCtfi in the 

VDB. 

3. Check if the act is a valid act and the act is 
present in the list of available acts for an workflow 
participant by invoking method hf nCheckValidAct of 
class TwxFAets in the VDB. 

4. Find out the current state, WF type, WF role, and the 
Act by invoking respectively the methods 
fnfirt-WFSt.at* - f nGftt.WFTvne . f TlfifttWFRPle r and fnfifitftCt 
of class TxWFArts in the VDB. 

5. Check with the workflow processor to determine if the 
act taken is consistent with the current state of the 
workflow and the role of the act taker (Customer 
/Performer) by invoking method b f nChe CkVa 1 1 d ft fit, of 
the class TxwFActs . 

6. Determine the new state of the workflow by calling 
the workflow processor. 

7 . Compute the new set of incompletions by by calling 
the workflow processor. 

8. Compute the new set of acts and the date prompts for 
the customer and performer using function 
AWSTAvai 1 ahlftArts of the workflow processor. If any 
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acts are disabled then those are removed form this 
new set of acts using the method bfnlsDisableri of 
class nrwrni sabiedActs of the VDB . 

9. Invoke the workflow event handler to interpret the 
scripts associated with the act, state, and the 
primary workflow. 

10. Send notifications the workflow participants 
informing the completion of the act by invoking the 
STF Router/Enqueuer . 



Classes and the methods invoked by the workflow updater 
module : 



Methods 


Class 


Action 


bf nCheckValidActs 


TxWFActs 


check if act is in 
Available Acts 
Table 


lfnGetCompletionTime 


TxWFInstance 


From VDB retrieve 
the Completion 
time 


If nGet Incomplet ionTime 


TxWFActs 


From VDB retrieve 
the Incompletion 
Time 


AWSTAvailableActs 




compute available 
acts for both 
customer and 
performer . 



Workflow Instantiator 



The workflow instantiator module is called by the 
transaction manager when it detects a request to initiate 
an instance of a business process or a workflow. The 
workflow instantiator instantiates business process and 
workflow records into the transactions database. This 
module creates workflow transaction records as specified 
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in business process definitions whenever a workflow is 
initiated. 

If the transaction manager detects a change in the 
transactions database that indicates a request for 
initiation of a new business process, the instant iator 
reads the business process definition and creates the 
transaction records for the business process and for the 
primary workflow of the business process according to the 
definition . 

If the transaction manager detects a change in the 
transactions database that indicates a request for 
initiation of a new workflow, the instantiator reads the 
workflow definition and creates the transaction record 
for the workflow according to the definition. 

The instantiator also performs the role to identity 
mapping so that the roles that are specified in the 
workflow definition get mapped to the proper identities 
in the transaction record of the workflow. 

The following is a description of the steps for 
implementing the workflow instantiator module. 

The instantiator creates an instance of a business 
process. It makes a copy of the definition. 

1. Check the length of the Business Process Name 
f szBPName ) is within limits. If beyond limits, return 

error . 

2. Validate the Instantiator Identity. Check if the name 
length is within limits. 

3. Check if Instantiator Identity is a valid user and 
registered. Method TnguireAnthnri nation from class 
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AuthMaint is used to determine if the user is valid and 
registered. This function accesses the Names /Routings 
database for validation, it calls the constructor of 
class NRPF IDENTITY. 

4. Check if the Instantiator Identity is authorized to 
instantiate business processes. It checks the authorities 
table in the names /routings database to check if this 
identity is authorized to instantiate business processes. 
The authorization method Tngni-rf»Ani-hoT--i raHon from class 
AuthMaint is called to determine the authorization. 

5. If the Customer name is specified, check if the name 
length is within limits. 

6. It the Customer name is specified, check that this 
name is valid and registered, method InquireAuthorization 
from class AuthMaint is used to determine if the user is 
valid and registered. This function accesses the 

Names /Routings database for validation, it calls the 
constructor of class NRDF IDENTITY . 

7. If the Performer name is specified, check if the name 
length is within limits. 

8. If the Performer name is specified, check that this 
name is valid and registered. Method TneruirgAuthorization 
from class Aut.hMflint is used to determine if the user is 
valid and registered. This function accesses the 
Names/Routing databases for validation, it calls the 
constructor Of class NRDFIDENTITY . 

9. If the Completion date is specified, check if the date 
string length is within limits. 
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10, If the Completion date is specif ied, convert the date 
string to long format . 

11 • If the Reply date is specified, check if the date 
string length is within limits. 

12. If the Reply date is specified, convert the date 
string to long format. 

13. If the Initiate date is specified, check if the date 
string length is within limits. 

14. If the Initiate date is specified, convert the date 
string to long format. 

15. If Completion and Reply dates are specified, the 
Reply date should be before the Completion date. 

16. If the Initiate date, if specified, it should be the 
earliest of all specified dates. 

17 . Create an instance of this business process . The 
constructor for class txbp instance is called for this 
purpose . 

18. The central workflow instance is created. The 
constructor for class TXWF INSTANCE is called for this 
purpose . 

19. Check for each organization role to identity any 
mapping which is specified at the time of initiation 
which overrides the mapping specified in the definition 
of the workflow, that the organization role and identity 
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do exist. To verify that the organization role is 
present, the constructor for class nrdforgrole is called. 
To verify that the identity is present, the constructor 
for class nrpptdenttty is called. 

20. Store the organization role in classes txbpasstkn and 
txwfasstgn from the transaction database classes to 
identity overrides. The constructors are called for these 
two classes. 

21. Return status. 

Workflow Language Interpreter 

Workflow definitions are stored in the definitions 
database. Included in these workflow definitions are 
conditions under which workflows become active and 
inactive, and the conditions under which the workflow 
server should take specified actions. These conditions 
and instructions are expressed in the workflow language. 

The workflow language interpreter interprets 
workflow language scripts. These scripts or workflow 
language segments contain workflow commands, such as the 
initiation or taking an act in a workflow. These scripts 
are part of the business process definition. These 
scripts are automatically generated by the application 
builder or equivalent design application. 

The following is a description of the steps and 
syntax for implementing the workflow language interpreter 
module . 

The workflow language interpreter interprets both 
user defined and system generated scripts, and performs 
the corresponding function defined in the script. The 
user can perform the following functions on a workflow. 
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The workflow language interpreter interprets user-defined 
as well as system generated scripts, and performs tests, 
functions, and assignments as presented in either kind of 
script. The syntax and capability of the ActionWorkf low 
scripting language are the same for the two kinds of 
scripts and is described as follows : 

Language Syntax 

A statement of the language is either an If 
Statement, an Action Statement or an Assignment 
Statement . 

An If Statement is either: 

If <boolean expression> statement 
1 ... statement n endif 

or 

If <boolean expression> statement 
1 ... statement s else statement s+1 ... statement 

n endif 

where <boolean expression> is: 

TRUE 
FALSE 

<boolean express ion> AND <boolean 

expression> 

<boolean express ion> OR <boolean 

expression> 
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* - 

<bound data name> OPERATION <numeric 

ISINSTATE (workflow name, state name) 
ISNOTINSTATE (workflow name, state name) 

where OPERATION is 

equal to 
not equal to 
greater than 

greater than or equal to 
less than 

less than or equal to 
An Action Statement is either: 

INITIATE workflow name, 
ACTIVATE workflow name, or 
ACT workflow name, act name 

An Assignment Statement is either: 

<bound data name> « <bound data name> 

or 

<bound data name> - <numeric term> 

2 . Capability 

The above-described syntax enables a script writer 
to start workflows, to act in workflows, to change bound 
data associated with a workflow, to test bound data 
associated with a workflow and conditional upon the 
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results follow one or another distinctly different course 
of action. 

The workflow language interpreter can be divided 
into the following functional modules: 

1. The Lexical Analyzer which defines the Workflow 
Language grammar. 

2. The Parser which parses the workflow scripts and 
invokes the corresponding semantic routines associated 
with the commands in the script. 

The main implementation details are as follows: 

1. The workflow event manager calls the workflow 
language interpreter and passes to it the Business 
Process Transaction ID, the Workflow Transaction ID, and 
the Script Type to be executed. 

2. Using this information the workflow language 
interpreter retrieves the appropriate workflow script 
from the definitions database using method 
bfnGetSrxiptNamff of the class DFWFAm-stai-g 

3. For the command Instantiate, the instant iator is 
invoked . 

4. For the command Activate, the workflow updater is 
invoked 

5. For the command TakeAnAct, the workflow updater is 
invoked* 

6. For external functions, the workflow language 
interpreter invokes the external function passing the 
specified parameters. 
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Workflow Event Handler 

The workflow event handler is called by the 
transaction manager to process the actions associated to 
acts and states in the workflow definition which are 
specified for a given workflow when an action is taken or 
a state reached in the workflow. It accomplishes this by 
reading the business process definition and by reading 
the workflow status information of the workflow 
transaction. 

The workflow event handler also looks in the 
definitions database for the workflow language scripts 
associated with acts and states of the workflow. The 
workflow event handler retrieves the language script 
corresponding to the act that was taken and passes the 
script to the workflow language interpreter for 
processing. The workflow event handler retrieves the 
language script corresponding to the state of the 
workflow and passes the script to the workflow language 
interpreter for processing. Then the workflow event 
handler retrieves the appropriate scripts associated with 
the states of the connecting workflows and passes them to 
the workflow language interpreter. Finally the workflow 
event handler retrieves the language script for the 
primary workflow of the business process for the current 
state of that workflow and passes that script to the 
workflow language interpreter for processing. 

The following is a description of the steps for 
implementing the workflow event handler module. 
The workflow event handler invokes the method 
AWSScriptToExecute of the workflow language interpreter 
to execute the following scripts associated with a 
workflow: 
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1 . The system generated act script 

2 . The user generated act script 

3 . The system generated state script 

4. The user generated state script 

5. The system generated state script of all the 
connected workflows 

6. The user generated state script of all the connected 
workflows 

7 . The system generated state script of the primary 
workflow 

8. The user generated state script of the primary 
workflow 

To implement steps 7 and 8, the method 
bfnlsCentralWF of class obTxWF INSTANCE is used to 
determine the Current WF is the primary workflow. Method 
obWFInstance is used to obtain the primary workflow. 

Agent Actions Manager 

The agent actions manager module executes the 
commands specified in a script. These include Initiate, 
Act, Follow-up as well as external functions. In this 
form the agent action manager is taking workflow acts by 
an "agent" on behalf of some role in the workflow. The 
commands that the "agents" execute are specified through 
the workflow language. 
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The following is a description of the steps for 
implementing the agent actions manager module. 

The agent actions manager is invoked by the 
workflow language interpreter when it finds a workflow 
action or external function to be performed in a workflow 
language script. If the workflow needs to be instantiated 
the instantiation is done by the workflow instantiator 
module. After instantiation a flag is set to indicate if 
activation or initiation is required. The agent action 
manager scans for all workflows which have this flag set 
and processes them. The process is described below. 

1. Log the activity using the method AWSWriteToLog . 

2. Obtain the current date and time. 

3. Get the next workflow to act on by using method 
TxWF INSTANCE of class TXWF INSTANCE , which is the act 
to take queue. 

4 . If the workflow to be processed is the primary 

workflow then change the Business Process status to 
f, IN_PROGRESS f \ The methods to use are bfnisCent.ralWF 
and bFnSetBPSt.afun. 

5. If the Customer, Performer and Observer (s) are not 
specified, then pick up defaults and assign all the 
workflow participants. The methods to use are 

IfnGfttfTUfif Td, lfnGet-.PftrfTH. lfnPut.Cust.Tri and 
lfnPutPerf Id. 

6. Specify the default Reply and Completion time using 
methods IfnGetRftplayDatfi and if nGetcompi Pt i nnTi G f 
class TxWF INSTANCE. If these times not present, 
obtain them through the definition defaults by using 
methods bfnGetCveleTimfrs of class PFWFCYr.LETTMEfi in 
the VDB. Assign the default using the methods 
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bfnPut.RfiplyDate and hfpPutCompletionTinie of class 
TxWFINSTftNCfi- 



7. Set up environment for first act to be taken. The act 
is dependent on the workflow type, request act in a 
workflow of type request and offer act in a workflow 
of type offer. 

8. Make an entry in the Available Acts Table using 
method bfnPutAct of the class obAvlActs. 



9. Take the first act if the workflow is to be 
Initiated. The act to be taken is placed in the act 
to process queue using method obTxWFActs of class 
TXWDACTS. Log the message using AWSLogMessage . 

10. The flag is reset to indicate that the processing 
is complete using method bfnResetlnstantiate of class 
obTxWFInstance . 



Methods and Modules invoked by Agent Actions Manager 
Module 



Methods 


Class 


Action 


lfnGetBPTid 


TxBP INSTANCE 


get the BP 
Transaction Id 


IfnGetWFTid 


TxWF INSTANCE 


get the WF 
Transaction Id 


bfnSetBPStatus 


TxBP INSTANCE 


set the status of 
BP instance 


lfnGetPerf Id 




get the performer 
Id 


lfnGetCustld 


TxWFNSTANCE 


aet the customer Id 


lfnGetCdmp let ion Time 


TxWFNSTANCE 


get cycle time of 
the WF 


TxWFActs 




queue the act to be 
taken 
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STF Router /Enqueuer 

The STF Router/Enqueuer module is called by the 
workflow updater to determine if the workflow currently 
being processed has a participant who must be notified in 
this workflow via an STF Processor. The router queues 
such transactions in the STF queue database for the 
appropriate STF processor to process . 

The following is a description of the steps for 
implementing the STF router/enqueuer module. 

1. The STF router/enqueuer first retrieves the BP and WF 
definition given the current WF transaction instance 
by using the methods t yrp tnst aupfi and obTxWFInstance 
of classes TfflP INSTANCE and txwftnstawpf. . 

2. Using the BP and WF Ids, the follow-up definition is 
retrieved from the definitions database using method 
DFWFoTlowUp of class dfwffot,t,owttp . if no 
notification required, just return. 

3. Get the notification status by using method 

NRDf Identity of class NRDF identity, if there is no 
need to do notification, just return. This is 
achieved through the method bf nG^t-Nnt i fy of class 
NRDC Identity in the vdb. 

4. Get the STFPrPdd using method If nGetSTFPrnriri of 

Class NRDfTdPnMl-y_ 

5. Write the Notification event in the STF queue 
database using method bfnPutEvent of class 
TxSTFonEUE . The date and time is computed. 

Databases 

Virtual Database 



WO 94/18620 



58 



PCT/US94/01287 



The present invention utilizes a Virtual Database 
for implementing the databases used by the system. The 
Virtual Database (VDB) is designed to be a collection of 
classes and methods. "Virtual" because it is DBMS 
independent. The VDB contains all the necessary storage 
structures to support the operations of the Workflow 
Server. More importantly, it defines a collection of 
methods for the manipulation of these structures and 
their instances. The basic domain as well as the classes 
for workflow definitions, transactions, schedules, names 
and routing, STF queue and server administration and 
configuration are described below. These classes define 
the attributes and methods for the data manipulation 
supporting the Workflow Server. 

Basic Domain Classes 
The basic domain classes used in the server are listed 
here in alphabetic order. 

act 

act = { request, offer, decline-request, agree, declare- 
complete, declare-satis fact ion, cancel, revoke, 
accept-off er, decline-offer, counter-offer, accept- 
counter-off er, decline-counter-offer, counter-with- 
request, declare-dissatis faction, question, answer, 
inform, open-speculation, continue-speculation, 
revise-offer, revise-request, follow-up, note, 
comment, initiate, activate, cancel-new-request, 
revoke-new-promise, revoke-new-offer, commit-to- 
commit, interim- report, delegate, accept- 
delegation, decline-delegation, cancel-delegation, 
declare-complete-delegation, declare-satis faction- 
delegation, revoke-delegation, start-with-promise, 
accept-starting-promise, decline-starting-promise } 
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bpatatus 

bpstatus = { inprogress, completed, aborted, suspended } 

configuration 

configuration — { optionl, option2, . . . } 

datetime 

Time is a built-in domain in the Virtual Database. Its 
counter part in the underlying DBMS will provide the 
actual implementation . 

datetimoof f set 

Datetimeof f set is a unit of time. Its value can range 
from seconds, days f weeks, and months, but is expressed 
in seconds . 

incompletion 

The various incompletions that need to be managed for the 
Customer and Performer in terms of Completions and 
Responses . 

incompletion - { CMC, CMR, CHC, CHR, PMC, PMR, PHC, PHR } 

1st letter - C for Customer, P for Performer 

2nd letter - M for My, H for His 

3rd letter - C for Completion, R for Response 

notification 

This domain class specifies the events which require 
notification. 

notification ■» {PerformerResponsePastDue, 
PerformerCompletionPastDue, PerformerCompletionComingDue, 
CustomerResponsePastDue, Act } 

ob jecttype 

objecttype = { BP, WF, STFProcessor } 
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privileges 

privileges *= { create, delete, modify, activate, 
schedule, assign privileges } 

state 

state « { request /offer, inactive, initial (after 
activation) agreement, completion, satisfaction, counter, 
decline, cancel revoke } 

string 

String is defined to be a character string with varying 
length. 

txstatus 

Status of the a transaction. 

txstatus « { pending, inprogress, complete } 

txtype 

List of various types of transactions processed by the 
server. 

txtype - { initbp, initwf, actinwf, bindappdata, 
getbounddata, getbounddatafieldattributes, status, 
availableacts, querywf, availablebp, acthistory, 
notificationstring } 

wf role 

wfrole = { customer, performer, observer } 
wf type 

wftype = { request, offer, note } 



Definitions Database 
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DFBP 

This class contains the Business Process (BP) definitions 
which includes information such as the BP Name, the BP 
Version, The person (ID) who created the BP, The date 
when this information was last modified, The Server ID 
which is the Home Server of this BP and the name of the 
file which contains the mapping of this BP . 

Attributes : 



IDEN 


IBPD^d 


CHAR 


SzBPName [BPNAME LEN] 


INT 


iVersion 


IDEN 


lBPAdmin 


LONG 


lLastModDate 


IDEN 


lHomeServerld 


CHAR 


szBPmaD [BLOBNAME LEN1 
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Methods : 



DFBP 


The Constructor of this Class: 
Depending on its first 
parameter it returns the first 
record from the table which 
matches the predicate, or 
creates a new Business Process 
in the Table with the given 
parameters, or creates a new 
version of an existing 
Business Process with the 
criven parameters 


BOOL bfnDelete 


Deletes the record whose 
parameters matches the DFBP 
class attributes 


IDEN lfnGetBPDid 


Returns the BPDid of the BP in 
context to the Class 
attributes 


INT ifnGetVersion 


Returns the BP Version of the 
BP in context to the Class 
attributes 


IDEN IfnGetLastModDate 


Returns the Date when the BP 
Definition was last modified 
in context to the Class 
attributes 


BOOL bfnPutBPMap 


Creates /Appends to the Map 
file of the BP, the data in 
memorv . 


BOOL bfnGetBPMap 


Retrieves the specified number 
of bvtes from the Map file. 


BOOL bfnNumListBP 


Returns the Number of BPs for 
which there exists a 
Transaction in the Tx Database 


BOOL bfnListBP 


Returns the List of BPs for 
which there exists a 
Transaction in the Tx Database 


BOOL bfnListDFBP 


Returns the list of all BPs 
defined in the Definitions 
Database . 


VOID vfnGetBPName 


Returns the BP Name of the BP 
in context to the Class 
attributes 



DFWF 

This class contains the Workflow definitions which 
include information such as the WF Name, the WFDid, the 
BPDid to which this workflow belongs, the type of 
workflow (primary or non primary) , the default IDs of the 
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customer and performer for this WF, the Repeat IF adn 
factor in case of repetitive WFs, the form names and the 
Conditions of satisfaction 



Attributes : 



IDEN 


lBPDid 


IDEN 


lWFDid 


BOOL 


bCentralWFFlaq 


CHAR 


szWFName rWFNAME LENT 


WFTYPE 


WFType 


IDEN 


lCusOraRole 


IDEN 


IPerOrcrRole 


INT 


iRepeatFieldld 


INT 


iRepeatFieldFactor 


CHAR 


szCustFormName TFORMNAME LEN] 


CHAR 


szPerFormName f FORMNAME LEN] 


CHAR 


szObsFormName fFORMNAME LEN] 


CHAR 


SzlnitFormName [FORMNAME LEN] 


CHAR 


szCOSfCOS LEN] 
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Methods 



DFWF 


Constructor of this class 
which depending on its first 
parameter it returns the 
first record from the table 
which matches the predicate 
or creates a new Workflow 
Definition in the Table with 
the aiven parameters 


BOOL bfnModify 


Modifies the Workflow 
Definition of an existing 
workflow (in context of the 
Class attributes) in the 
Table with the given 
parameters 


BOOL bfnModifyForms 


Modifies the form names of 
an existing workflow (in 
context of the Class 
attributes) in the Table with 
the aiven form names 


BOOL bfnPutCOS 


Appends/ Creates the 
conditions of satisfactions 
of an existing workflow (in 
context of the Class 
attributes) in the Table with 
the aiven COS 


BOOL bfnGetCOS 


Retrieves the Conditions of 
Satisfaction of an existing 
workflow (in context of the 

1 mm mm mm mm m^m - - J _ _ ^ ^ \ 

Class attributes) 


IDEN lfnGetWFDid 


Returns the WFDid of an 
existing workflow (in context 
of the Class attributes) 


WFTYPE fnGetWFType 


Returns the WF type of an 
existing workflow (in context 
of the Class attributes) 


TT"\TTM 1 £ n fid*- ct- r\v-r*T} r\ 1 a 

ItlibcuLUStUrgKOlc 


Keuurns ine customer iu or an 
existing workflow (in context 
of the Class attributes) 


IDEN IfnGetPerfOrgRole 


Returns the Performer ID of 
an existing workflow (in 
context of the Class 
attributes) 



DFWFOBS 

This class contains ; the workflow observer 
definitions which includes information such as the WFDid, 
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the BPDid to which this workflow belongs , the Observer ID 
for the WF . 



Attributes 



IDEN 


lBPDid 


IDEN 


lWFDid 


IDEN 


lObserver 



Methods 





ine consirucuor ror tms 
Class , which depending on 
its first parameter it: 
creates a new Workflow 
Observer Definition in the 
Table with the given 
parameters , or returns the 
first record from the table 
which matches the predicate 


BOOL bfnDelete 


Deletes the record whose 
parameters matches the 
DFWFOBS class attributes 


BOOL bfnGetWFObsList 


Returns the List of 
Observers defined for the 
workflow (in context of the 
Class Attributes) 


INT nfnGetWFObsCount 


Returns the Number of 
Observers defined for the 
workflow (in context of the 
Class Attributes) 



DFBP CONTAINER 

This class contains the Business Process Container 
Information (the Container ID for a particular BP) . 

Attributes : 



IDEN 


lBPDid 


IDEN 


IContainerld 
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DFBPCONTAINER 


Creates a new Container 
Definition for a BP with the 
given parameters (in context 
of the Class Attributes) It 
also inserts a record in 
another table (DFCONTAINER) 
with the Container ID and 
the number of fields 


IDEN lfnGetContainerld 


Returns the Container ID (in 
context of the Class 
Attributes) 



DFFIELD 

This class contains the Container Field Information 
which includes the Container ID to which the field 
belongs, the Field ID ,the data type of the field, its 
maximum length, its attributes, and its initial Value. 

Attributes 



IDEN 


IContainerld 


IDEN 


lFieldld 


INT 


iDataTvpe 


INT 


iMaxLen 


ATTRIBUTES 


Attr 


CHAR 


szInitValflNIT VAL LEN] 


Methods 



DFFIELD 



Creates a new Container 
field record with the 
given parameters. It 
also inserts a record in 
another table 
(DFBDFIELDLIST) with the 
BPDid, the Field ID and 
the field name. 



DELINK 

" This class contains the Workflow Link Information 
which includes the BPDid to which this LINK belongs, the 
ID of the workflow from which the LINK starts, whether 
the link starts from an act or from a state, the 
act/state IDs from which the Link starts and at which 
link ends, and the Destination State ID. 



*»• iP*^wri t^-f- rurrT tot II C 



WO 94/18(20 



67 



PCT/US94/01287 



Attributes ; 



IDEN 


IBPDid 


IDEN 


lFromWFid 


BOOL 


bFromActOrState 


IDEN 


lFromActOrStateld 


IDEN 


lToWFid 


BOOL 


bToActOrState 


STATE 


ToState 



DFLINK 


The Constructor for this 
Class that creates a new 
Link record with the 
given parameters. Using 
WFName WFID is first got 
from DFWF 


BOOL bfnGetWFLinks 


Returns all the links to 
a aiven WFID 



DFBP ASSIGN 

This class contains all the Identity to 
Organization role mappings at the Business process level . 



Attributes 



IDEN 


IBPDid 


IDEN 


lldentitvld 


IDEN 


lOrcrRole 



DFBP AS SIGN 


The constructor of this 
class that depending on 
its first parameters 
creates a new BP 
assignment in a given 
BPDid with the given 
parameters or returns the 
first record from the 
table which matches the 
predicate 


IDEN IfnGetldentity 


Returns the Identity ID 
(in context of the Class 
attributes) 



DFWFASSIGN 

This class contains all the Identity to 
Organization role mappings at the Workflow level. 
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Attributes : 



IDEM 


lBPDid 


IDEN 


lWFDid 


IDEN 


lldentitvld 


IDEN 


lOraRole 


WFROLE 


WFRole 



Methods : 



DFWF ASSIGN 


The constructor of this 
class that depending on 
its first parameter it 
creates a new workflow 
assignment in a given 
WFDid and BPDid with the 
given parameters or 
returns the first record 
from the table which 
matches the Dredicate 


IDEN lfnGetldentity 


Returns the Identity ID 
(in context of the Class 
attributes) 



DFBPNOTIFICATIOH 

This class contains all notification string 



information at 


BP level. 


Attributes : 




IDEN 


lBPDid 


NOTIFICATION 


NEvent 


CHAR 


SzNstrino TNSTRING LENj 



DFBPNOTIFICATION 


This is the constructor for 
this class that creates a 
new BP notification for a 
given BPDid 


BOOL bfnGetEventString 


Returns the BP notification 
strincr of an event in a BP 



DPWFNOTIFICATION 

This class contains all notification string 
information at workflow level 
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Attributes : ' 

IDEN I lBPDid 

IDEN lWFDid 

NOTIFICATION NEvent 

CHAR rszNstrinarNSTRING LEN1 



Methods : 



DFWFNOT IF ICATION 


This is the constructor 
for this class that 
creates a new workflow 
notification for a given 
WFDid and BPDid 


BOOL bfnGetEventString 


Returns the workflow 
notification string of an 
event at workflow level. 



DPWPCYCLETIMES 

This class contains all the Cycle times defined for 
a workflow. 

Attributes : 



IDEN 


lBPDid 


IDEN 


lWFDid 


LONG 


ITimel 


LONG 


lTime2 


LONG 


lTime3 


LONG 


lTime4 



Methods : 



DFWFCYCLETIMES 


This is the constructor 
for this class that 
creates a new record with 
the given cycle times for 
a aiven WFDid and BPDid 


BOOL bfnGetCycleTimes 


Returns the cycle times 
(in context of the Class 
Attributes) 


DFWFCYCLETIMES 


Returns the first record 
from the table which 
matches the predicate 


IDEN IfnGetWFDid 


Returns the WFDid (in 
context of the Class 
Attributes) 



DFWFDISABLEDACTS 

This Class contains information of all the Disabled 

Acts • 
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Attributes 



IDEN 


lBPDid 


IDEN 


IWFDid 


WFROLE 


WFRole 


ACT 


Act Id 


Methods 



DFWFDISABLEDACTS 


This is the constructor 
for this class that 
creates a new record 
with the given WFrole 
and Actid for a given 
WFDid and BPDid 


BOOL bfnlsDisabled 


Returns whether a 
particular Act for a 
particular WFRole in a 
given workflow is 
disabled or not . 



DFWPACT STATE 

This contains all the definitions of the workflow 
acts and States (their names and IDs) for all business 
processes and their workflows. 

Attributes 



IDEN 


lBPDid 


IDEN 


IWFDid 


BOOL 


bActOrState 


INT 


ActOrState 


CHAR 


szUserDefName fUSERDEF STRING LEN1 


CHAR 


szGenScript [BLOBNAME LEN] 


CHAR 


SzUserScript fBLOBNAME LEN] 



Private Methods 


BOOL bfnlsAvail 


Returns whether an Act/ 
state is Available for a 
criven Workflow. 


BOOL bfnGetScriptName 


Returns the Script Name 
given the BP and WF DIds 
the Act/State and the 
type of script (User 
Defined or System 
Generated) required . 
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Methods : 



DFWF ACTS TATE 


This is the Constructor 
iui Lais Liass unax. 
creates a new record with 
the given Act/State , and 

given WFDid and BPDid 


BOOL bfnPutScript 


Inserts the given Script 
into a blob file 


DFWFACTSTATE 


Returns the first record 
from the table which 
matches the predicate 


BOOL bf nGetWFScript 


Returns the required data 
from the script file (In 
context of the Class 
Attributes) given the 
Script Type 



DFWFCONTAINER 

This class contains the Workflow Container 
Information (the Container ID for a particular workflow 
in a given BP) . 

Attributes : 



idenI 


lBPDid 


ideni 


lWFDid 


idenI 


IContainerld 



Methods : 



DFWFCONTAINER 


Creates a new Container 
Definition for a workflow with 
the given parameters (in 
context of the Class 
Attributes) 


IDEN IfnGetContainerld 


Returns the Container ID (in 
context of the Class 
Attributes) 



DFWFACTSTATEBDREF 

This Class contains the workflow Act /State Bound 
Data reference information. 
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IDEN 


lBPDid 


IDEN 


lWFDid 


BOOL 


bActOrState 


INT 


ActOrStateld 


WFROLE 


WFRole 


IDEN 


IContainerld 



WO 94/18620 

Attributes 



Methods : 



DFWFACTSTATEBDREF 


The Constructor for 
this Class that 
inserts a record 
with the with the 
given parameters 


IDEN IfnGetContainerld 


Returns the 
Container ID (in 
context of the Class 
Attributes) 


BOOL bfnGetFieldAttrList 


Returns the list of 
Field Attributes for 
the given conditions 
(parameter values) 


BOOL bfnGetNumFieldAttrList 


Returns the number 
of Field Attributes 
for the given 
conditions 
(parameter values) 



DFWFFOLLOWUP 

This class contains all the Follow-up information 
of a workflow. 
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Attributes 



IDEN 


lBPDid 


IDEN 


lWFDid 


BOOL 


bPRFUFlaq 


BOOL 


bPRFURecur 


LONG 


lPRFUOf f set 


INT 


iPRFUCount 


BOOL 




BOOL 




LONG 


lPCFUOf f set 


INT 


iPCFUCount 


BOOL 


bCRFUFlaa 


BOOL 


bCRFURecur 


LONG 


lCRFUOffset 


INT 


iCRFUCount 


BOOL 


bPCRemFlaq 


LONG 


IPCRemOff set 


BOOL 


bActNotifvFlaa 



Methods 



DFWFFOLLOWUP 


The constructor of this 
class that depending on 
its first parameter 
inserts a record in the 
FollowUp Table with the 
Given Parameters or 
returns the first record 
from the table which 
matches the predicate 


BOOL bfnGetPerfRespInfo 


Returns the Performer 
Response Information (in 
context of the Class 
Attributes) 


BOOL bfnGetPerfCompInfo 


Returns the Performer 
Completion Information 
(in context of the Class 
Attributes) 


BOOL bfnGetCustRespInfo 


Returns the Customer 
Response Information (in 
context of the Class 
Attributes) 


BOOL bfnGetPerfRemlnfo 


Returns the Performer 
Reminder Information (in 
context of the Class 
Attributes) 


BOOL bfnGetActNotifyFlag 


Returns the Notify flag 
(in context of the Class 
Attributes) 
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DFBDFZELDLIST 



Attributes 



IDEN 


lBPDid 


char 


szFieldNamef FIELDNAME LEN] 


IDEN 


lFieldld 



Methods 

No Methods 



Transactions Database 
TXBP INSTANCE 

This Class contains information of all instances of 
Business Process Transactions. This information consists 
of the Transaction ID of the Business Process (BPTid) , 
the Business Process definition ID (BPDid) , the BP Status 
and whether the BP Instance is active or not. 



Attributes 



IDEN 


lBPTid 


IDEN 


lBPDid 


BOOL 


bis Active 


BPSTATUS 


BPStatus 
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Methods 



TXBP INSTANCE 


The Constructor for this Class 
that returns the first record # 
from the table which matches 
the predicate 


Create Instance 


Creates an instance of the 
given BP in the Transactions 
Database table 

(TXBP INSTANCE) • blsActive will 
still be FALSE 


BOOL bfnActivate 


Changes the Status (blsActive) 
of the current BP (In context 
to the Class Attributes) from 
FALSE to TRUE 


Buuij DinoetcFotatus 


ocls uiie orouatus uu uixc given 

status ID (In context to the 
Class Attributes) 


IDEN lfnGetBPDid 


Returns the BPDid of the 
Business Process Instance (In 
context to the Class 
Attributes) 


IDEN lfnGetBPTid 


Returns the BPTid of the 
Business Process Instance (In 
context to the Class 
Attributes) 


BOOL bfnNumListBP 


Returns the number of BPs that 
have been Instantiated 


BOOL bfnListBP 


Returns a list of all BPs that 
have been Instantiated to 
memory or to the file 
specified 


BOOL bfnDelete 


Deletes the BP transaction 
(specified by the class 
attributes) from the table. 


BOOL bfnAbort 


Sets the BPStatus to ABORT (In 
context to the Class 
Attributes) (Further Actions 
are vet to be defined) 


BOOL bfnSuspend 


Sets the BPStatus to SUSPEND 
(In context to the Class 
Attributes) (Further Actions 
are vet to be defined) 
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BOOL bfnNumListQueryQF 


Returns the number of BP 
Instances (instantiated 
between the specified start 
date and the end dates) for the 
given Identity, having the 
specified Organization Role, 
(If bPending is TRUE then only 
those BPs are included where 
Acts are pending) 


BOOL bfnListQueryWF 


Returns a list of all BP 
Instances (instantiated 
between the specified start 
date and the end dates) for the 
given Identity, ■ having the 
specified Organization Role, 
(If bPending is TRUE then only 
those BPs are included where 
Acts are pending) 



TXBPASSIGN 

This class contains all the Identity to 
Organization role mappings at the BP level for BP 
Transaction. These mappings if present override the 
corresponding DFBPASSIGN mapping for a given BPDid for 
that particular instance of the BP (BPTid) . 



Attributes 



IDEN 


lBPTid 


IDEN 


lOrerRole 


IDEN 


lldentitvld 



Methods 



TXBPASSIGN 


The constructor of this 
class that depending on 
its first parameter 
creates a new BP 
assignment in a given 
BPTid with the given 
parameters or returns the 
first record from the 
table which matches the 
predicate 


IDEN lfnGetldentity 


Returns the Identity ID 
(in context of the Class 
attributes) 
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TXWF INSTANCE 

This Class contains information of all instantiated 
Workflows. This information consists of the Transaction 
IDs of the Workflow (WFTid) and the Business Process 
(BPTid) to which it belongs, whether it is a Primary 
workflow or not, the Workflow definition ID (WFDid) , the 
reply/ completion and initiate date, the present State, 
the Customer and Performer for this workflow Instance, 
the conditions of satisfaction for this workflow and 
whether this workflow instance has been instantiated or 



not 




Attributes 




IDEN 


lBPTid 


IDEN 


IWFTid 


BOOL 


bCent ra 1WFF laa 


IDEN 


lWFDid 


DATETIMET 


IReplvDate 


DATETIMET 


IComplet ionTime 


DATETIMET 


UnitiateTime 


STATE 


Stateld 


IDEN 


lCustld 


IDEN 


IPerfld 


BOOL 


bCOSFlaa 


CHAR 


szCondOfSatisfnTBLOBNAME LEN] 


BOOL 


blnstantiate 
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Methods : 



TXWF INSTANCE 


The Constructor for 
this Class that returns 
the first record from 
the table which matches 
the predicate 


BOOL bfnlnstantiateCentralWF 


Creates an Instance of 
the Primary workflow of 
a BP Instance, given 
the BPDid and BPTid 
with the given 
parameters. For the 
given BPDid, the 
workflow with CWF Flag 
TRUE is fetched from 
the DFWF table to 
create this CWF 
instance. A new WFTid 
for this workflow 
Instance is returned 


BOOL bfnCreatelnstance 


Creates an Instance of 
the non Primary 
workflow of a BP 
Instance, given the 
BPDid and BPTid with 
the given parameters. A 
new WFTid for this 
workflow Instance is 
returned 


BOOL bfnSetState 


Sets the STATE of the 
given workflow Instance 
to the state specified. 


BOOL bfnGet Instantiate 


Returns the Status of 
the Instantiate flag 
for the given workflow 
Instance (In context of 
the Class Attributes) . 
This indicates if the 
specified workflow 
instance has been 
instantiated or not . 


BOOL bfnModify 


Modifies the specified 
parameters in the 
WFInstance (In context 
of the Class 
Attributes) and returns 
the WFTid 


IDEN IfnGetCustld 


Returns the Customer ID 
for the given workflow 
Instance (In context of 
the Class Attributes) 
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IDEN lfnGetPerfld 


Returns the Performer 
ID for the given 
workflow Instance (In 
context of the Class 
Attributes) 


BOOL bfnGetStateName 


Returns the User 
Defined State Name 
corresponding to the 
current state of the 
workflow Instance, (In 
context of the Class 
Attributes) . 


BOOL bfnGetFormName 


Returns the form name 
(corresponding to the 
WFRole) of the workflow 
Instance. (In context of 
the Class Attributes) 


BOOL bfnlsCentralWF 


Returns TRUE if the 
current WF is a primary 
WF 


IDEN IfnGetBPTid 


Returns the BPTid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


IDEN lfnGetWFTid 


Returns the WFTid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


BOOL bfnReset Instantiate 


Sets the Instantiate 
Flacr to FALSE 


IDEN lfnGetWFDid 


Returns the WFDid for 
the given workflow 
Instance (In context of 
the Class Attributes) 


STATE ifnGetState 


Returns the current 
State of the given 
workflow Instance (In 
context of the Class 
Attributes . 


BOOL bfnGetPending 


Return whether or not 
an act is pending for 
this Workflow Instance 


BOOL bfnPutCOS 


Creates /Appends to the 
Blob file of the 
workflow Instance , the 
COS data in memory 
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BOOL bfnGetCOS 


If the COSFlag is TRUE 
it retrieves the 
specified number of 
bytes from the Blob 
file of this workflow 
Instance containing the 
Conditions of 
Satisfaction else the 
COS is retrieved from 
the workflow 
Definitions table 


BOOL bfnPutCustld 


Modifies the Customer 
ID for this WF Instance 
to the given ID (in 
context of the Class 
attributes) 


BOOL bfnPutPerfld 


Modifies the Performer 
ID for this WF Instance 
to the given ID (in 
context of the Class 
attributes) 


LONG IfnGetReplyDate 


Returns the Reply date 
for this workflow 
Instance (in context of 
the Class attributes) 


LONG lfnGetCompletionTime 


Returns the Completion 
date for this workflow 
Instance (in context of 
the Class attributes) 


BOOL bfnPutReplyDate 


Modifies the Reply date 
for this WF Instance to 
the given date (in 
context of the Class 
attributes) 


BOOL bfnPutCompletionTime 


Modifies the Completion 
date for this WF 
Instance to the given 
date (in context of the 
Class attributes) 


BOOL bfnGetCOSFlag 


Returns the COS Flag 
for this workflow 
Instance (in context of 
the Class attributes) 


BOOL bfnPutCOSFlag 


Modifies the COS Flag 
for this WF Instance to 
the given value { in 
context of the Class 
attributes) 
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TXWFOBS 

This class contains the Workflow Observer 
Transactions information which includes information such 
as the WFTid, the BP Instance (BPTid) to which this 
workflow belongs, and the Observer ID for the workflow 
instance . 



Attributes 

private : 



IDEM 


lBPTid 


IDEN 


lWFTid 


IDEN 


lObserver 



Methods 



TXWFOBS 



The constructor of this 
class that depending on 
its first parameter it 
creates a new Workflow 
Observer Transaction in 
the Table with the 
given parameters or 
returns the first 
record from the table 
which matches the 
predicate 



TXWFASSIGN 

This class contains all the Identity to Organization role 
mappings at the Workflow level for Workflow Instances . 

Attributes 



private : 



IDEN 


lBPTid 


IDEN 


lWFTid 


IDEN 


lOraRole 


IDEN 


lldentitvld 


WFROLE 


WFRole 
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Methods : 



TXWF ASSIGN 


The constructor of this 
class that depending on its 
first parameter returns the 
first record from the table 
which matches the predicate 
or creates a new workflow 
assignment in a given WF 
Instance (WFTid) for a BP 
Instance (BPTid) with the 
criven parameters 


WFROLE fnGetWFRole 


Returns the WFRole (in 
context of the Class 
attributes) 


IDEN If nGet Identity 


Returns the Identity ID (in 
context of the Class 
attributes) 



TXWFINCOMPLETION 

This class contains the Incomplet ions information 
for all Instantiated workflow 



IDEN 


lBPTid 


IDEN 


lWFTid 


INCOMPLET ION 


Incld 


LONG 


IComoletionTime 


LONG 


lFollowUDTime 


LONG 


lReminderTime 


LONG 


ICount 
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Methods ; 



TXWF INCOMPLETION 


The Constructor for 
this class that returns 
the first record from 
the table which matches 
the predicate or 
inserts a new workflow 
Incompletion for a 
given workflow Instance 
(WFTid) for a BP 
Instance (BPTid) with 
the aiven parameters 


. IDEN IfnGetBPTid 


Returns the BPTid for 
the workflow Instance 
(in context of the 
Class attributes) 


IDEN IfnGetWFTid 


Returns the WFTid for 
the workflow Instance 
(in context of the 
Class attributes) 


INCOMPLETION fnGetlncId 


Returns the 

Incompletion ID for the 
WF Instance (in context 
of the Class 
attributes) 


DATETIMET 
lfnGetCompletionTime 


Returns the Completion 
Time for the WF 
Instance (in context of 
the Class attributes) 


VOID vfnPutCompletionTime 


Modifies the Completion 
time for this workflow 
Instance to the given 
time (in context of the 
Class attributes) 


DATETIMET If nGetFollowUpTime 


Returns the FollowUp 
Time for the WF 
Instance (in context of 
the Class attributes) 


VOID vfnPutFollowUpTime 


Modifies the follow up 
time for this workflow 
Instance to the given 
time (in context of the 
Class attributes) 


DATETIMET If nGetReminderTime 


Returns the Reminder 
Time for the workflow 
Instance (in context of 
the Class attributes) 
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VOID vfnPutReminderTime 


Modifies the Reminder 
Time for this workflow 
Instance to the given 
time (in context of the 
Class attributes) 


BOOL bfnGetFirstlncompletion 


Returns TRUE if a 
record for the given 
reminder/ followup prior 
to the given time is 
available and the 
Incompletion 
information is made 
available in the Class 
Attributes , 


BOOL bfnGetNext Incompletion 


Returns TRUE if the 
next record for the 
given reminder/f ollowup 
prior to the given time 
is available and the 
Incompletion 
information is made 
available in the Class 
Attributes . 


LONG IfnGetCount 


Returns the Count 
(number of 

incompletions) for the 
workflow Instance (in 
context of the Class 
attributes) 


VOID vfnlncCount 


Increments the count. 



TXWF AVAIL ACTS 

This class contains information of available acts for a 
Workflow Instance. 



Attributes 



IDEN 


lBPTid 


IDEN 


IWFTid 


WFROLE 


WFRole 


ACT 


Act 


BOOL 


bReplvFlaq 


BOOL 


bCompletionFlaq 
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Methods 



TXWFAVAILACTS 


The constructor for this 
Class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
new Available Act for a 
given workflow Instance 
(WFTid) for a BP 
Instance (BPTid) with 
the aiven parameters 


BOOL bfnNumAvailActs 


Returns the number of 
Acts available for a 
given WFRole in a 
WFInstance. The Impure 
Flag indicates whether 
an Act is waiting to be 
processed by the 
Transaction Manager 


■ROOT. h*FnT, -i 


Returns the list of Acts 
available for a given 
WFRole in a WFInstance. 
The Impure Flag 
indicates whether an Act 
is waiting to be 
processed by the 
Transaction Manaqer 


BOOL bfnDeleteAHActs 


Deletes all the Acts for 
a given workflow 
instance from the 
Available Acts table 


BOOL bfnGetReplyFlag 


Returns the value of the 
Reply Flag for the WF 
Instance (in context of 
the Class attributes) 


BOOL bfnGetCompletionFlag 


Returns the Completion 
Flag for the workflow 
Instance (in context of 
the Class attributes) 



TXWFACTS 

This class contains information of Acts that are to be 
taken (Queue) in all Workflow instances . (Acts taken by 
the client but not yet processed by the Server) . 
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Attributes 



I DEN 


lTxia 


BOOL 


dstf riaa 


IDEN 


iBPTia 


IDEN 


lwFTia 


ACT 


Act id 


WFROLE 


WFRole 


T AMP 


iKcu ±v J> line 


LONG 


IComDletionTime 


IDEN 


lWho 


DATETIMET 


lWhenReaistered 


DATETIMET 


lWhenTaken 


BOOL 


bProcessed 


LONG 


iReturnCode 
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Methods : 



TXWFACTS 


The Constructor for this 
Class that or inserts a 
new WF Act into the 
table (Actid) for a 
given WF Instance 
(WFTid) in a BP Instance 
(BPTid) with the given 
parameters or inserts a 
new WF Act into the 
table (Actid) for a 
given WF Instance 
(WFTid) in a BP Instance 
(BPTid) with the given 
parameters. It also 
inserts a record in the 
table TXSTFADDINFO or 
returns the first record 
from the table which 
matches the oredicate 


IDEN lfnGetTxId 


returns the Tx ID for 
the Act that has to be 
taken (in context of the 
Class attributes) 


BOOL bfnGetReturns 


Returns the parameters 
STFProcId, ReturnCode 
from the current Class 
attribute values. It 
also returns STFTxID and 
User Id (from 
TXSTFADDINFO) 


VOID vfnPutRetValue 


Modifies the Return 
Code . 


BOOL bfnGetFirstlnQueue 


Returns the first Act 
(to be processed ) from 
the Queue) 


VOID vfnActComplete 


Updates the bProcessed 
flacr to TRUE 


BOOL bfnCheckValidAct 


Checks if the given Act 
is valid for the WFRole 


IDEN lfnGetBPTid 


Returns the BPTid to 
which this Act belongs 
(in context of the Class 
attributes) 


IDEN IfnGetWFTid 


Returns the WFTid to 
which this Act belongs 
(in context of the Class 
attributes) 
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ACT fnGetAct 


Returns the Actid of 
this Act belongs (in 
context of the Class 
attributes) 


WFROLE fnGetWFRole 


Returns the WFRole 
taking this Act (in 
context of the Class 
attributes) 


STATE fnGetWFState 


Returns the State of 
this Act (in context of 
the Class attributes) 


WFTYPE fnGetWFType 


Returns the WFType (got 
from DFWF) of the 
workflow to which this 
Act belongs (in context 
of the Class attributes) 


DATETIMET 
lfnGetlncompletionTime 


Returns the 
completion/reply time 
for the given 
Incoirroletion 


DATETIMET 
lfnGetCompletionTime 


Returns the completion 
time (in context of the 
Class attributes) 


DATETIMET If nGet Reply Time 


Returns the reply time 
(in context of the Class 
attributes) 


BOOL bfnNumListActTaken 


Returns the Number of 
acts present in the 
Queue for the given 
BPTid and WFTid 


BOOL bfnListActTaken 


Returns the list of acts 
present in the Queue for 
the given BPTid and 
WFTid to memory or a 
specified file 



TXSTFADD INFO 

This class contains additional information for all 
transactions which come via the STF Processor 

Attributes : 



IDEN 


ITxid 


IDEN 


ISTFProcId 


IDEN 


ISTFTxId 


IDEN 


lUserld 
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TXSTFQUEUE 

This class contains information of all outgoing 
Transactions via the STF Processor. 



Attributes 



IDEN 


ISTFProcessor 


IDEN 


lBPTid 


IDEN 


lWFTid 


NOTIFICATION 


NEvent 


IDEN 


lUserld 


DATETIMET 


IComoletionTime 


DATETIMET 


iNot i f i cat ionT ime 


DATETIMET 


lWhenReaistered 


DATETIMET 


lWhenRead 


IDEN 


lTxId 


Methods 



TXSTFQUEUE 


The Constructor for this 
class 


BOOL bfnGetEvent 


returns the earliest 
Message Record (When 
Registered has the 
earliest date, and 
WhenRead is 0) from the 
STF Queue for the given 
STF Processor 


BOOL bfnSetReadTime 


Sets the WhenRead 
DateTime field to the 
given Value (In context 
to the Class Attributes) 


BOOL bfnPutEvent 


Inserts a record into 
the STFQueue with the 
given parameters (Sets 
WhenRead to 0 and 
WhenRegistered to the 
Current Time) . 



TXBPBD 

This class contains BP level Bound Data field IDs and 
values related to all BP Instances 
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Attributes 



I DEN 


lBPTid 


IDEN 


lFieldld 


CHAR 


SZValueflNIT VAL LEN] 



Methods 



TXBPBD 



The constructor of this 
class that depending on 
its first parameter that 
inserts a Record in the 
TXBPBD table for the 
given BP Transaction 
with BPTid and Fieldld 
(which is obtained from 
DFFIELDLIST using the 
Field Name) and the 
field value or returns 
all the Bound Data 
fields (associated with 
the given BP Instance, 
BPTid) . to specified 
file/memory or returns 
the number of Bound 
Data fields associated 
with the given BP 
Instance (BPTid) 



TXWFBD 

This class contains workflow level Bound Data field IDs 
and values related to all instantiated WFs in BP 
Instances 



Attributes 



IDEN 1 


lBPTid 


IDEN 


lWFTid 


IDEN 


lFieldld 


CHAR I 


szValueflNIT VAL LEN1 
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Methods 



TXWFBD 



The constructor of this 
class that depending on 
its first parameter 
inserts a record in the 
TXWFBD table for the given 
WF Instance (WFTid) in the 
specified BP Transaction 
with WFTid ,BPTid ,FieldId 
(which is obtained from 
DFFIELDLIST using the 
Field Name) and the field 
value or returns the 
number of Bound Data 
fields associated with the 
given WF Instance in the 
specified BP Transaction ( 
BPTid) returns all the 
Bound Data fields 
(associated with the 
given WF Instance in the 
specified BP 
Transaction (BPTid) ) . to 
spe c i f ied file/ memory 



Global Method 



BOOL bfnlsPure 



This method returns TRUE 
if there are no acts 
pending in the TXWFACTS 
Queue for the given WF 
Instance in the specified 
BP Transaction • If there 
are acts in the Queue then 
it returns FALSE . 



Names and Routings Database 
DFSTFPROC 

This class contains information of all STF 
Processors including their IDs , names and network 
addresses . 



IDEN 


ISTFProcId 


CHAR 


szSTFProcName [STFPROCNAME LEN] 


CHAR 


SZNetAddress [NETADDRESS LENT 
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Methods 



DFSTFPROC 


The Constructor for this 
Class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the DFSTFPROC 
table for the given STF 
Processor Name and 
Network Address It 
generates the STFProcId 
and returns it 


BOOL bfnGetSTFProcName 


Returns the STF 
Processor Name (in 
context of the Class 
attributes) 


BOOL bfnGetNet Address 


Returns the Network 
Address of the STF 
Processor (in context of 
the Class attributes) 


BOOL bfnDelete 


Deletes the record from 
the DFSTFPROC table 
whose values are in 
context of the class 
attributes . 


BOOL bfnListSTFProcs 


Returns information of 
all STF Processors in a 
set of Structures. 



NRDFORGROLE 

This Class contains the Organization Role ID to 
Organization Role Name mapping. 

Attributes : 



IDEN 


lOraRole 


CHAR 


szOraName fORGROLE LENT 
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Methods 



NRDFORGROLE 


The Constructor for this 
Class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the NRDFORGROLE 
table containing the 
OrgRole ID and the 
corresponding Name 


IDEN lfnGetOrgRole 


Returns the OrgRole ID 
(in context of the Class 
attributes) 


BOOL bfnDelete 


Deletes the record from 
the NRDFORGROLE table 
whose values are in 
context of the class 

attributes . y^.,.. •., 



NRDF IDENTITY 

This class contains information related to all the 
Identities including their Name, Network Address, Postal 
Address, Phone/Fax and other information. 

Attributes : 



IDEN 


lldentitvld 


CHAR 


szldentitvName [IDENTITY LEN] 


CHAR 


szNet Address fNETADDRESS LEN] 


CHAR 


s zPost a 1 Address [POSTALADDRESS LEN] 


CHAR 


szPhone [PHONE LENT 


CHAR 


szFax [PHONE LEN1 


CHAR 


szDepartment [DEPARTMENT LEN] 


CHAR 


SzTitle [TITLE LEN] 


CHAR 


szLocation [LOCATION LEN] 


CHAR 


s zCommen t [ COMMENT LEN 1 


BOOL 


bNotifv 


IDEN 


ISTFProcId 
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Methods 



NRDFIDENTITY 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the 
NRDFIDENTITY table 
containing the 
Identityld, the 
corresponding Identity 
name, and other Identity 
information obtained from 
the aiven parameters 


BOOL bfnDelete 


Deletes the record from 
the NRDFIDENTITY table 
whose values are in 
context of the class 
attributes. 


BOOL bfnGetNotify 


Returns the Notify Status 
(in context of the Class 
attributes) . Notify 
Status will be TRUE if 
the Identity wants a 
Notification of an event . 


IDEN IfnGetSTFProcId 


Returns the STF Processor 
ID (in context of the 
Class attributes) . If the 
Identity is not an STF 
Processor then 0 is 
returned. 


IDEN lfnGetldentityld 


Returns the Identity ID 
(in context of the Class 
attributes) . 


BOOL bfnGetldenNameList 


Returns information of 
all Identities in a set 
of Structures. 



NRDFGROUP 

This class contains all the Groupld to Group Name 
mapping. 

Attributes : 



IDEN 


1 Group Id 


CHAR 


szGroucName TGROUPNAME LEN1 
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Methods 



NRDFGROUP 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the NRDFGROUP 
table containing the 
Groupld, and the 
corresponding Group name 


BOOL bfnDelete 


Deletes the record from 
the NRDFGROUP table whose 
values are in context of 
the class attributes. 


IDEN lfnGetGroupId 


Returns the Group ID (in 
context of the Class 
attributes) . 



NRD F GROUP AS SIGN 

This class contains all the Groupld to Identityld 
mapping . 

Attributes : 



IDEN 


lGroupId 


IDEN 


lldentitvld 
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Methods 



NRDF GROUP ASS I GN 


The Constructor for 
this class that returns 
the first record from 
the table which matches 
the predicate or 
inserts a Record in the 
NRDFGROUPASSIGN table 
containing the Groupld, 
and the Identity Id 


BOOL bfnDelete 


Deletes the record from 
the NRDFGROUPASSIGN 
table whose values are 
in context of the class 
attributes . 


BOOL bfnNumList Group 


Returns the number of 
Groups which contain 
the given Identityld as 
a member 


BOOL bfnListGroup 


Returns information of 
all Groups which 
contain the given 
Identityld as a member, 
to file or memory as 
specified 


BOOL bfnNumList Iden 


Returns the number of 
Identities in the 
specified GroupID 


BOOL bfnListlden 


Returns information of 
all Identities which 
belong to the specified 
group, to file or 
memory as specified 



NRD F 6 ROUP RO LEAS SIGN 



Attributes : 



IDEN 


lGroupId 


IDEN 


lOrcrRole 
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Methods 



NRDFGROUP ROLE AS SIGN 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
record in the NRDFGROUP - 
ROLEASSIGN table 
containing the Groupld, 
and the Organization Role 


BOOL bfnDelete 


Deletes the record from 
the NRDFGROUP— ROLEASSIGN 
table whose values are in 
context of the class 
attributes . 


BOOL bfnNumListRole 


Returns the number of 
Groups which contain the 
given Organization Role 
as a member 




Returns information of 
all Groups which contain 
the given Organization 
Role as a member, to file 
or memorv as specified 


BOOL bfnNumListGroup 


Returns the number of 
Organization Roles in the 
specified GroupID 


BOOL bfnListGroup 


Returns information of 
all Organization Roles 
which belong to the 
specified group, to file 
or memorv as specified 



NRDFXDENRO LEAS SIGN 

This class contains all the Identityld Organization Role 
mapping. 



Attributes : 



IDEN 


lldentitvld 


IDEN 


lOraRole 
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Methods ; 



NRDF IDENROLEASS IGN 


The Constructor for this 
class that returns the 
first record from the 
table which matches the 
predicate or inserts a 
Record in the NRDFIDEN- 
ROLEASSIGN table 
containing the 
Identityld, and the 
Organization Role 


BOOL bfnDelete 


Deletes the record from 
the NRDFIDEN- ROLE AS SIGN 
table whose values are 
in context of the class 
attributes . 


BOOL bfnNumListRole 


Returns the number of 
Org. Roles which contain 
the given Identityld as 
the Identity Id 


BOOL bfnListRole 


Returns information of 
all Org. Roles which 
contain the given 
Identityld as the 
Identity ID, to file or 
memory as specified 


BOOL bfnNumListldentity 


Returns the number of 
Identities with the 
specified Ora. Role 


BOOL bfnList Identity 


Returns information of 
all Identities with the 
specified Org. Role, to 
file or memory as 
specified 



Schedule Database 

This class contains all the Business Process 
schedule information including time when it has to be 
. next initiated and the Recurring period of that BP 
SCBP SCHEDULE 



Attributes : 



IDEN 


lBPDid 


DATETIMET 


llnitTime 


DATETIMET 


IRecPeriod 
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Methods : 



SCBPSCHEDULE 


The Constructor for this 
class that inserts a 
Record in the SCBPSCHEDULE 
table for the given STF 
Processor Name and Network 
Address It generates the 
STFProcId and returns it 
or returns the first 
record from the table 
which matches the 
predicate 


BOOL bfnDelete 


Deletes the record from 
the SCBPSCHEDULE table 
whose values are in 
context of the class 
attributes . 


DATETIMET IfnGetlnitTime 


Returns the Initiation 
Time of the BP (in context 
of the Class attributes) 


DATETIMET If nGetRecTime 


Returns the Recurring 
period of the BP (in 
context of the Class 
attributes) 


IDEN IfnGetBPDid 


Returns the BP ID (in 
context of the Class 
attributes) 


VOID vfnPutlrtitTime 


Updates the Initiation 
Time for the BP with the 
specified time (in context 
of the Class attributes) 


BOOL bfnGetFirstBPSchedule 


Returns the first BP 
scheduled to be Initiated 
(Where the InitTime is 
less than the specified 
time) (the Class 
attributes are updated) 


BOOL bfnGetNextBPSchedule 


Returns the next BP 
scheduled to be Initiated 
(Where the InitTime is 
less than the specified 
time) (the Class 
attributes are updated) 



AWSAUTH 

This class contains information related to each 
Identities database access privileges. 
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IDEN 


lldentitvld 


OBJECT TYPE 


Obiectld 


PRIVILEGES 


Privilege 


Methods 



BOOL Grant 


Updates the privileges of 
the specified Identity to 
the given set of 
Privileges 


BOOL Revoke 


Revokes the specified 
privileges from the 
specified Identitv 


BOOL InquireAuth 


Returns the Privileges of 
the specified Identitv 



CONFIGINFO 

This Class contains the configuration information of a 
particular installation including the path and file name 
of the Logfile, the interval of the Server polling, the 
path of the Blob file and the maximum number of BP 
instances . 



Attributes 


• 


CHAR 


szLocrFilePath [LOGFILEPATH LEN ] 


CHAR 


szLocrFileName TLOGFILENAME LEN ] 


INT 


iPollInterval 


CHAR 


szBlobFilePath [BLOBFILEPATH LEN] 


INT 


iMaxBPInst 


LOGOPTIONS 


LoaOpts 


Methods : 



BOOL bfnSetConf iglnfo 


Sets the configuration of 
an installation to the 
specified values 


BOOL bfnGetConf iglnfo 


Returns the Configuration 
of the Installation. 



ERRMSG 

Contains the Error code to error Number mapping. 



Attributes 



INT 


iErrNo 


LONG 


lErrCode 



*r* t it f 
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ERRMSG 


The Constructor for this 
Class 


BOOL bfnPutErrNo 


Inserts a record with an 
ErrNo and the 
corresponding ErrCode, 


INT ifnGetErrNo 


Gets the ErrNo 
corresponding to the 
specified ErrCode. 



MBS SAGE Q 

This Class contains the Message Queue which is used by 
the components of the Server for internal communication, 

Attributes 



PROCESS 


Sender 


PROCESS 


Recipient 


MESSAGE 


Messacre 


LONG 


IP a rami 


LONG 


lParam2 


LONG 


lParam3 


LONG 


lParam4 


CHAR 


szParamfPARAM LEN] 


DATETIMET 


lWhenPosted 


Methods 



MESSAGEQ 


The Constructor for this 
class 


BOOL bfnPostMessage 


Puts the given message 
into the Message Queue 
with the specified 
Sender and Recipient 
fields 


BOOL bfnGetMessage 


Gets the first message 
marked to the specified 
recipient from the 
Messaae Queue. 


BOOL bfnFlushMessage 


Deletes all messages 
from the Messacre Queue . 



Administration and Configuration Database 
Server Management 



ServerMgmt 

Attributes 
lServerld 



identifier 
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szServerName 
Methods 

StartServer 
StopServer 



string [ sz_servername 3 



/* The method 
StopServer should 
find all BPs that 
have the server as 
Home & issue 
warning to the 
current users */ 



Login 
Logout 

L i st Login Act vit i e s 
User Maintenance 



UserMaint 

Attributes 
HfiprTd 
LoginName 
Password 

Methods 

AddNewUser 
RemoveUser 
ModifyUserlnfo 



ref (Identity) 

string 

string 



or ref (Group) 



Authorization Maintenance 



Object 

Attributes 

Qbjectld 
Object Type 

AuthMaint 

Attributes 
User 

Obiectld 
Privilege 
Grant Opt ion 
Methods 
Grant 
Revoke 



ref (BP) or ref (WF) or 

ref (STFProcessor) 

ob jecttype 



ref (User) 
ref (Object) 
privilege 
bool 



InquireAuthorization 

Business Process Maintenance 



BPMaint 

Methods 

AbortBP 
■ DeleteBP 
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SuspendBP 

Resume BP 

ArchiveBP 

ListAvailBPs 

ListActiveBPs 

DeleteBPDefinition 

Workflow Maintenance 



WFMaint 

Methods 

ListAllWF 



STF Processor Maintenance 



STFMaint 

Methods 

RegisterSTFProc 
DeregisterSTFProc 



Backup and Restore 



Backup 

Attributes 
BPId 



string 



BackupPate time 
BackupTime time 
BackupMedaa enum 



/* Business 
Process name is 
NULL f implies 
backup/restore 
entire DB */ 



Methods 

Backup 
Restore 



Database Management 

DBMgmt 

Methods 

CheckDatabase 
IndexDatabase 
Reor gan i z eDat aba s e 

Configuration 

Config 

Attributes 

MaxUserCount int 
MaxOpenBPs int 
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Version string 

Methods 

SetConf iguration 
GetConf iguration 



STF Quoua Database 

STF Additional Information Class 

The server as a service stores additional fields 
required by STF processors . The STF Processor Id, the STF 
Transaction Id and the Userld are stored. 

TxSTFAddllnfo 

The STF Queue database is implemented through two 
classes TXSTFADD INFO and TXSTFQUEUE which are desribed 
with other classes of the transaction database. 

B. WORKFLOW APIs 
Workflow Transactions API 

This section describes the functions performed by 
the transactions API. A description of each function is 
set forth followed by the syntax of a call to the 
function, with specification of each parameter passed to 
the function. From this information, a suitable code 
segment can be written to implement the function. 

AWSTINITBP 

Description 

This function creates a new instance of a 
previously defined Business Process (BP) . The BP Name is 
passed and a BP Id is returned. This Id will be required 
for all subsequent calls to this API. This call also 
activates the Primary workflow. To create this instance 
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of the Business Process the Name specified for the 
IdentityName must be authorized. Optionally the mapping 
of Organization Role Names to Identity Names may be 
provided. This . overrides the default mapping (if any). 

Syntax 

VOID FAR PASCAL AWSTINITBP (STRING szBPName, 

STRING szlnitiatorName, STRING 
szCustomerName, STRING szPerf ormerName, 
DATETIMESTRING szCompletionDate, 
DATETIMESTRING szResponseDate, 
DATETIMESTRING szlnitiateDate , 
INT iCount, LPORG2ID lpOIPtr, 
LPIDEN lpBPTid, STRING szCWFName, 
LPERRCODE IpError) 
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Parameters 
Name 


Tvoe 


^A«r«r lotion 


szBPName 


STRING 


Business Process 
Name. This BP must 
have previously 
been defined and 
the name known to 
the server. 


szlnit iatorName 


STRING 


Name of the person 
or identity 
initiating the 
business process. 
The identity must 
be authorized to 
activate the 
business process. 


szCustomerName 


STRING 


Customer Identity 
Name . 


s zPe r f orme rName 


STRING 


Performer Identity 
Name . 


szCompletionDate 


DATETIMESTRING 


The date by which 
the Primary 
workflow must be 
completed . 


szResponseDate 


DATETIME STRING 


The date by which 
negotiation must be 
complete . 


szlnitiateDate 


DATETIMESTRING 


The Date when this 
workflow is to be 
initiated by the 
server. If this 
date is not 
specified then the 

Du51H6S5 c iOCcoo J-s 

initiated 
immediately. 


iCount 


INT 


The number of 
Organization Role 
to Identity mapping 
entities , 
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IpOIPtr 


LPORG2ID 


Pointer to an array 
of structures which 
contains the 
mapping of 
Organization Role 
to Identities. In 
the structure 
0RG2ID, the 
application must 
set the GLOBAL or 
LOCAL flag to 
identify whether 
the ORG2ID 
overriding is at BP 
level or at WF 
level. 


loBPTid 


LPIDEN 


returns BPTid. 


szCWFName 


STRING 


returns the name of 
Primary Workflow. 


loError 


LPERRCODE 


Error Code. 



Return Value 

The function returns the Business Process Instance 
Id, BPTid and Primary WF name, szCWFName. 



AWSTINITWF 
Description 

The business process this workflow belongs to must 
have been instantiated. The application must supply the 
Business Processes' Business Process Transaction Id. The 
Identity Names of the Customer and Performer are optional 
if defaults have been specified. The dates for completion 
and reply are optional. If these dates are NULL values, 
the defaults specified by the workflow's definition (if 
any) will be used. The Initiate date is optionally 
specified only for the Primary workflow to initiate it at 
a later date. Optionally the mapping of -Organization 
Roles to Identity Names may be passed. These override the 
default mapping if any. 



WO 94/18620 

Syntax 



108 



PCT/US94/01287 



VOID FAR PASCAL AWSTINITWF (BPTID lBPTid, STRING szWFName, 
STRING szlnitiatorName, STRING 
szCustomerName, STRING szPerf ormerName, 
DATETIMESTRING szCompletionDate, 
DATETIMESTRING szResponseDate , 
DATETIMESTRING szlnitiateDate , 
INT iCount, LPORG2ID lpOIPtr, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


szWFName 


STRING 


The name of the workflow 
to be initiated. The 
primary workflow can be 
initiated prior to an 
initiation date specified 
in the AWSINITBP function, 
or a previously specified 
initiation date changed 
using this function by 
specifying the name of the 
primary workflow. If the 
specified workflow is not 
the primary workflow, then 
the Business Process this 
workflow belongs to must 
have already been 
initiated. 


s z I ni t i a torName 


STRING 


The Identity Name of the 
person initiating the 
workflow. The workflow 
will be initiated only if 
the identity has the 
authorization . 


szCustoxnerName 


STRING 


The Identity Name of the 
person who is the Customer 
for this workflow. 


szPerf ormerName 


STRING 


The Identity Name of the 
person, who is the 
Performer for this 
workflow. 


szCompletionDate 


DATETIMESTRING 


The date by which this 
workflow must be 
comDleted. 


szResponseDate 


DATETIMESTRING 


The date by which 
negotiation must be 
complete. 


szlnitiateDate 


DATETIMESTRING 


The Date when this 
workflow is to be 
initiated by the server. 
If this date is not 
specified then the 
workflow is initiated 
immediately. This date can 
be specified only for the 
Primary workflow. 


iCount 


INT 


The number of Organization 
Role to Identity mapping 
entities . 
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lpOIPtr 


LPORG2ID 


Pointer to an array of 
structures which contains 
a mapping of Organization 
Role to Identity Names. 


loError 


LPERRCODE 


Error Code* 



Return Value 

None 

AWSTACTINWF 

Description 

This function instructs the workflow server to 
perform the act specified in the specified workflow of a 
specific business process. The Business Process 
Transaction ID and Workflow Name must be specified- The 
identity performing the act must be specified. The server 
records the act to be taken and updates the workflow. The 
server may take an unspecified time to take the act 
because of the queuing of the acts to be taken. If the 
client application issues a query when the act is 
pending, the application will receive status values which 
are not updated and this will be indicated by CLEAR or 
PENDING flag of the query APIs . 

Syntax 

VOID FAR PASCAL AWSTACTINWF (STRING szSTFProcName, 

STRING szSTFTxName, STRING szSTFUserName, 
BPTID lBPTid, STRING szWFName, ACT Act, 
DATETIMESTRING szCompletionDate, 
DATETIMESTRING szReplyDate, STRING 
szParticipantName, LP I DEN IpTxId, 
LPERRCODE IpError) 
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Parameters 



rt one 




T\ a ierioti on 
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s zSTFP rocName 


STRING 


Only the transaction calls 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 
NULL. 


szSTFTxName 


STRING 


Only the transaction calls 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 


szSTFUserName 


STRING 


Only the transaction calls 
made via STF Processor 
will pass this. Workflow 
applications which 
directly use this call 
should set this field to 
NULL* 


IBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


s zWFName 


STRING 


The Transaction Id of the 
workflow in which to take 
the act. 


Act 


ACT 


The act to take, e.g., 
Recruest, Acyree, etc. 


s zComplet ionDat e 


DATETIMESTRING 


Completion date can be 
optionally specified 
whenever permitted or 
recommended has to be 
specified for all Customer 
/ Performer Counter Acts. 


IReplyDate 


DATE TIME STRING 


Reply date has to be 
specified for the 
following acts: Customer / 
Performer Counters, 
Declare Completion and 
Declare dissatisfaction. 


szlnitiatorName 


STRING 


Identity of the person 

reciuesviuy une act . 


IpTxid 


LP I DEN 


Unique Transaction Id 
returned by the API. This 
Id is used to inquire 
about the status of taking 
the Act. 


IpError 


LPERRCODE 


Error code returned by the 
server. 
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* _ 

Return Value 

The unique transaction Id generated by the server 
is returned. The application calling the transaction API , 
AWSTACTINWF can use this Id to inquire about the status 
of the Act. The API call to be used is 
AWSTACTSTATUSQUERY . 

. AWSTACTSTATUSQUERY 



Description 

This function gets the status of the Act requested 
by the AWEA via the transaction API call AWSTACTINWF . The 
Status indicates whether the act was taken successfully 
or an error occurred. In case of an error, a diagnostic 
error code will be returned. 

Syntax 

VOID FAR PASCAL AWSTACTSTATUSQUERY (IDEN ITxId, 

STRING szSTFProcName, STRING szSTFTxName , 
STRING szSTFUserName, LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lTxid 


I DEN 


Unique Transaction Id 
returned by the API - 
AWSTACTINWF. This Id is 
to be used to identify 
the Act being inquired 
about . 


szSTFProcName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id . 
Workflow applications 
which directly use the 
Transaction API can 
ignore this parameter. 


szSTFTxName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id. 
Workflow applications 
which directly use the 
Transaction API can 
ianore this parameter. 


szSTFUserName 


STRING 


Only the transaction 
calls made via STF 
Processor will get back 
the corresponding Id. 
Workflow applications 
which directly use the 
Transaction API can 
ignore this parameter. 


IpError 


LPERRCODE 


Error code returned by 
the server. This 
indicates whether the 
Act was taken 
successfully or an 
error occurred. 



Return Value 

In case the call is made by a workflow application 
via an STF Processor, then the szSTFProcName, szSTFTxName 
and the szUserName are returned along with Error (which 
indicates the status of the Act).. If the call is made by 
an application directly, then the Application needs to 
check only the error code. 
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AWSTBINDAPPDATA 

Description 

Binds data- to a business process or workflow 
instance. Application data can be attached or bound to a 
business process or workflow. Later this information can 
be retrieved. The data field name and data value are 
supplied. Data type is specified at definition time. Any 
number of data items may be bound. When data is bound to 
the business process, the workflow name is specified by 
NULL. 

Syntax 

VOID FAR PASCAL AWSTBINDAPPDATA (BPTID lBPTid, STRING 




szWFName, STRING szParticipantName, 
INT iFields, 

LP TXBDF IELD STRUCT lpTxBDFieldStructPtr , 
LPERRCODE IpError) 
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Parameters 



Kama 


Tvpe 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The 
Id of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the 
workflow in which to 
bind the data. The 
workflow name is 
specified as NULL if 
data is to be bound 
to the business 
process . 


szParticipantName 


STRING 


Identity of the 
person requesting 
binding of 
application data. 


iFields 


INT 


The number of fields 
to bind with the 
workflow 


lpTxBDFieldStructPtr 


LPTXBDFIEL 
DSTRUCT 


A pointer to a array 
of structures 
containing the field 
name, type, size and 
the field value. The 
structure 
BDFIELDSTRUCT 
contains an element 
Of type ATTRIBUTES. 
This parameter will 
be ignored by the 
API . 


IpError 


LPERRCODE 


Error code returned 
bv the server. 



Return Value 

Data is bound to the workflow. 



AWSTGETAPPDATA 

Description 

A set of data fields and values are returned 
corresponding to the data fields bound to a workflow 



■• purrT / mil C 



116 

WO 54/18*20 PCTKJS94/01287 

instance. The number of fieids and for each field the 
field name, type and its value are returned. 



Syntax 

VOID FAR PASCAL AWSTGETAPPDATA (BPTID lBPTid, STRING 
szWFName, STRING szFormName, 
WFROLE WFRole, STRING szPart icipantName, 
LP INT lpiFieldsPtr, BOOL bFileOrMemory, 
LPADFIELDSTRUCT lpADFieldStructPtr , 
STRING szFileName, LPERRCODE IpError) 
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Parameters 



Name 


Tvpe 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 

Br . 


szWFName 


STRING 


The name of the workflow 
from which to retrieve 
bound data. The workflow 
name should be set to 
"GLOBALBPDATA" to 
retrieve business process 
bound data. 


szForxnName 


STRING 


The form name is 

retupnftd This was stored 

along with the bound 
data. 


WFRole 


WFROLE 


The WFRole of the 
participant. This need 
only be specified if the 
participant has more than 
one role in the workflow. 


s zParticipantName 


STRING 


The name of the person or 
identity requesting 
Application Data 
associated with the 
workflow . 


lpiFieldsPtr 


LP INT 


The number of bound data 
field to be retrieved. 


bFileOrMemory 


BOOL 


Flag to indicate File or 
Memory mode of receipt of 
data from the API . 


lpBDFieldStructPtr 


LPBDFIELDSTRUCT 


A pointer to an array of 
structures , where the 
field name, type and the 
field values are 
returned. The structure 
ADFIELDSTRUCT contains an 
element of type 
ATTRIBUTES. This 
parameter is to be 
ignored by the 
Application. The API 
returns the list of 
attributes if 
or xxeurnemory is 
ITS_MEMORY . Application 
Data fields defined as 
HIDDEN for the particular 
WFRole , requesting 
Participant, and current 
workflow state are 
returned as NULL strinas. 
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SZr liBMoiue 


STRING 


File name where the API 
should deposit the 
results of the call if 
the flag bFileOrMemory is 
ITS FILE. 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

lpiFields contains the number of fields retrieved. 
BDFieldStruct contains the field name, field type and 
field value for all the fields retrieved. 

AWSTGETAPPDATAFIELDATTRXBUTES 

Description 

This functions returns the list of application data 
field names arid their attributes for a specified act or 
state for a specific workflow of a Business Process. The 
attributes returned are Read-Only , Editable and Hidden. 
These attributes are Boolean. 

Syntax 

VOID FAR PASCAL AWSTGETAPPDATAFIELDATTRIBUTES (BPTID lBPTid, STRING 
szWFName, BOOL bActORState, ACT STATE ActOrState, 
•STRING szFormName, STRING szParticipantName, 
WFROLE WFRole, LP INT lpiFields, 

LPFLDNAMEATTR lpFldNameAttr , BOOL bFileOrMemory, 
STRING szFileName, LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. 
The Id of a 
previously 

lnSLanulaLcQ tic . 


szWFName 


STRING 


The Transaction 
Id of the 
workflow from 
which to 
retrieve, neia 
attributes of 
the bound data . 


bActORState 


BOOL 


-Boole an flag to 
indicate the 
type of the 
ACTSTATE 
parameter. 


ActOrState 


ACTSTATE 


The field 
attributes 
specified for 
this act or 
state are 
returned. 


szForraName 


STRING 


The form name is 
returned . This 
was stored along 
with the bound 
data. 


s zP a rt i cipant Name 


STRING 


The name of the 
person or 
identity 
requesting Field 
Attributes oi 
the Application 
Data associated 
with the 
workflow . 


WFRole 


WFROLE 


The workflow 
role of the 
identity. 


lpiFieldsPtr 


LP INT 


The number of 
bound data 
fields for which 
the attributes 

a. i. tcuucncu. 


lpWFMomentBDField 


LP WFMOMENTBDF I E - LD S TRUCT 


A pointer to a 
array of 
structures 
containing the 
field name and 
field 

attributes . 
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bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory 
mode of receipt 
of data from the 
API. 


o »t C* ^ 1 aMama 
ozr J.J. tsvt cxiivti 




r us name wnere 
the API should 
deposit the 

call if the flag 
bFileOrMemory is 
its file; 


IpError 


LPERRCODE 


Error code 
returned by the 
server. 



Return Value 

lpiFieldPtr is updated with the number of fields for 
which the field attribute is returned. 
FieldStruct contains the field attributes for the 
specified act. 

AWSTSTATUS 

Description 

This function returns status of the workflow 
instance for a specific participant. The state of the 
workflow, the current incompletions with the dates, etc. 
Information is returned in the STATUS structure. 

Syntax 

VOID FAR PASCAL AWSTSTATUS (BPTID lBPTid r STRING szWFName, 
STRING szParticipantName, WFROLE WFRole, 
LP INT lpCurrent, LPSTATUS IpStatusPtr, 
LPERRCODE IpError) 
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Parameters 



Name 


Tvpe 


Description 


IBPTid 


BPTID 


Business Process 
Transaction iq. ine xa or 
a previously instantiated 
BP. 


szWFName 


STRING 


The workflow name whose 
status is desired 


szParticipantName 


STRING 


The status of the workflow 
is returned with respect 
to this Identity. 


WFRole 


WFROLE 


The WFRole of the 
participant. This field 
is only required if the 

paruicipanr is dolii 
customer and performer. 


lpCurrent 


LPINT 


The current status - CLEAR 
i.e.., no Acts in the 
queue waiting to be 
serviced or PENDING i.e.., 
some acts are in the queue 
yet to be serviced. 


IpStatusPtr 


LP STATUS 


The STATUS structure 
contains the Status String 
and various Completion and 
Reply dates. These dates 
depend on the role of the 
Identity. 


IpError 


LPERRCODE 


Error code returned by the 
server. 
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Return Value 

Structure Status contains the status of the specified 
workflow. 

Element Status .StatusString contains the string 

describing the current state of the workflow. 

The following Completion and Reply dates are returned: 



Customer 


Performer 


Completion reouested 


Completion due 


Reolv due to Performer 


Reply due to Customer 


Completion due by 
Performer 


Completion requested by 
Customer 


Reply due bv Performer 


Reply due by Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned. 

AWSTAVAILABLEACTS 

Description 

Returns a structure that contains the list of 
available acts in the specified workflow for the role 
that the participant has in the workflow. 

Syntax 

VOID FAR PASCAL AWSTAVAILABLEACTS (BPTID IBPTid, 
STRING SzWFName, WFROLE WFRole, 
STRING szParticipantName, BOOL cDialog, 
BOOL bFileOrMemory, LP INT lpiCountPtr, 
STRING szFileName, LPACTINFO ActPtr, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lBPTid 


BPTID 


Business Process Transaction 
Id. The Id of a previously 
instantiated BP . 


szWFName 


STRING 


The name of the workflow whose 
status is desired 


WFRole 


WFROLE 


The workflow role of the 
identity. This field is only 
required if the participant is 
both customer and performer in 
the workflow. 


szParticipantName 


STRING 


The name of the person or 
identity for which the list of 
available acts is returned. 


cDialog 


BOOL 


If cDialog is TRUE, then a 
dialog box is presented to the 
user to select a specific ace . 
In this case, the list of 
available actions returned by 
this function will be the 
selected one. 

If cDialog is FALSE, then no 
dialog box is presented and all 
available acts are returned. 


bFi leOrMemory 


BOOL 


Flag to indicate File or Memory 
mode of receipt of data from 
the API . 


lpiCountPtr 


LP I NT 


Number of acts returned in the 
structure 


szFileName 


STRING 


File name where the API should 
deposit the results of the call 
if the flag bFileOrMemory is 
ITS FILE. 


lpActPtr 


LP ACT INFO 


A pointer to an array of 
structures which contains the 
list of acts, i.e., Act Names, 
user-defined names for the 
acts . 


IpError 


LPERRCODE 


Error code returned by the 
server. 



Return Value 

lpiCountPtr is updated with the number of possible acts 
the Identity can take in the current workflow. 
The structure array passed is filled with the Acts Names 
and user-defined names . 
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Description 

This function returns the list of workflows that 
the named person or identity has as a specific 
Organization Role. The list of workflows is selected from 
the set of instantiated business processes that have the 
same business process name. The workflow status for each 
workflow is returned. 

Syntax 

VOID FAR PASCAL AWSTQUERYWF (STRING szParticipantName , 
STRING szOrgRole, WFROLE WFRole, 
STRING szBPName, 
DATETIMESTRING szStartDate, 
DATETIMESTRING szEndDate, BOOL bPending, 
BOOL cDialog/ BOOL bFileOrMemory, 
LP INT lpiCount, STRING szFileName, 
LPWFSNAPSHOT IpWFSnapShot , 
LPERRCODE IpError) 
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Parameters 




4 . 




Name 


1 Type 


Description 


szParticipantName 


STRING 


The participant for which 
the list of workflows is 
returned. 




szOrgRole 


STRING 


The organization role of 
the participant. Only 
workflows that have this 
specific OrgRole are 
selected. If OrgRole is 
specified as NULL then all 
workflows are selected 
regardless of the role. 




WFRole 


WFROLE 


The workflow role of the 
identity. This field is 
only required if the 
participant is both 
customer and performer or 
is an observer in the 
workflow. 




szBPName 


STRING 


The workflows are selected 
only for the specified 
BPName. If BPName is NULL, 

then relevant workf low*; a ro 
selected regardless of the 
business process. 




szStartDate, 


D ATET IME S TRING 


These dates specify a date 




szEndDate 




range of due dates for 
which the list is 
constructed. If StartDate 
is NULL then the list 
includes all relevant 
workflows 




bPending 


BOOL 


If Pending is TRUE then the 
list workflows includes 
only those workflows where 
action is pending. The 
workflows which needs to be 
initiated are also 
included. Otherwise it 
includes workflows where 
action is not Dendina. 




cDialog 


BOOL 


If cDialog is TRUE, then a 
dialog box is presented to 
the user to select a 
specific workflow. In this 
case, the list of workflows 
returned by this function 
will be the selected one. 
If cDialog is FALSE, then 
no dialog box is presented 
and all available workflows 
are returned. 
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bFileOrMemory 


BOOL 


Flag to indicate File or 
Memory mode of receipt of 
data from the API . 


szFileName 


STRING 


File name where the API 
should deposit the results 
of the call if the flag 
bFileOrMemorv is ITS FILE. 


lpiCount 


LP INT 


Returns the count of 
workflows selected. 


lpWFSnapShot 


LPWFSNAPSHOT 


Pointer to a list of 
selected workflows. Each 
workflow includes Business 
Process name & Id, workflow 
name, Customer, Performer, 
Completion and Reply Dates, 
Status and Form name 


IpError 


LPERRCODE 


Error code returned by the 
server. 



Return Value 

lpiCount , the number of workflows in the list. 
lpWFList points to a list of WFLIST structures. 
The structure returns several dates depending on role of 
the Identity. 



Customer 


Performer 


Completion reauested 


Completion due 


Reply due to Performer 


Reply due to Customer 


Completion due by Performer 


Completion requested by 
Customer 


Reply due by Performer 


Reply due by Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned 



AWSTAVAILABLEBP 

Description 

This function returns a list of BP Names. 



Syntax 
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VOID FAR PASCAL AWST AVAI LAB LEBP (STRING szParticipantName , 
BOOL cDialog, INT iBPStatus, 
LP INT IpiCount, BOOL bFileOrMemory, 
LPBPINFO IpBPInfo, STRING szFileName, 
LPERRCODE IpError) 



Parameters 



Mane 


Type 


Description 


s zPart ic ipant Name 


STRING 


The participant for which the 
list of BPs is returned. 


cDialog 


BOOL 


If cDialog is TRUE, then a 
dialog box is presented to the 
user to select a specific BP. 
In this case, the list of BPs 
returned by this function will 
be the selected one. 
If cDialog is FALSE, then no 
dialog box is presented and 
all available BPs are 
returned. 


iBPStatus 


INT 


Indicate the iBPStatus 
required. ACTIVE_BPS select 

INACTIVE selects all BPs in 
the definition database . 


IpiCount 


LP INT 


The number of BPs returned. 


bFileOrMemo ry 


BOOL 


Flag to indicate file or 
memory mode of receipt of data 
from the API. 


lpBPInfo 


LPBPINFO 


A pointer to an array of 
BPINFO structures that contain 
the business process name and 
Id. 


szFileName 


STRING 


File name where the API should 
deposit the results of the 
call if the flag bFileOrMemory 
is ITS FILE. 


IpError 


LPERRCODE 


Error code returned by the 
server . 



Return Value 

IpiCount, the number of workflows in the list. 

BPListPtr points to a linked list of BPINFO structures 

that contain the Business Process Name & Id. 



AWSTACTHISTORY 
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Description 

This call returns a list of Acts taken in the 
specified business process for a specific workflow. If 
workflow name is NULL f then the history of the entire 
business process, i.e., list of all acts taken of all 
workflows is returned. 

Syntax 



VOID FAR PASCAL AWSTAC THIS TORY (STRING szParticipantName, 
BPTID lBPTid, STRING SzWFName, 
LP INT lpiCount, BOOL bFileOr Memory, 
STRING szFileName, 
LPACTSTAKENLIST lpActsList, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


szParticipantName 


STRING 


The participant for 
which the list of 
Acts taken is 
returned . 


lBPTid 


BPTID 


Business Process id 


szWFName 


STRING 


The workflow name 
for which the list 
of acts taken is 
returned. If no 
name is specif ied, 
i.e., the string is 
null/ then the act 
history for the 
entire Business 
Process is 
returned . 


lpiCount 


LP INT 


Pointer to an 
integer. The 
function returns 
number of Acts 
returned . 


bFileOrMemory 


BOOL 


Flag to indicate 
file or memory mode 
of receipt of data 
rrom une Air i . 


szFileName 


STRING 


File name where the 
iiirx snouiu aeposn 
the results of the 
call if the flac 
bFileOrMemory is 
ITS FILE. 


lpActsList 


LP ACTS T AKENL 1ST 


Pointer to 
ACT S T AKENL 1ST 


IpError 


LPERRCODE 


Error code returned 
bv the server. 



Return Value 

lpiCount, the number of Acts in the list. 

lpActsList points to a list of ACTSTAKEN structures that 
contain Business Process Name & id, Workflow Name & id, 
Act Name & id, Act Date and the ParticipantName who took 
the act . 
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AWSTGETNSTRIKG 
Description 

The notification string for the event is retrieved. 
If no such string is present for the workflow then 
default string associated with the Business Process is 
retrieved. If no default string is present then a null 
string is returned. 

Syntax 

VOID FAR PASCAL AWSTGETNSTRING (BPTID IBPTid, STRING 
szWFName, EVENT Notif icationEvent , 
STRING szNotif icationString, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


IBPTid 


BPTID 


Business Process id 


szWFName 


STRING 


Workflow name. 


Not i f i ca t i onE ven t 


EVENT 


This parameter 
specifies the event 


szNot if icationString 


STRING 


The notification 
strincr returned. 


IpError 


LPERRCODE 


Error code returned 
by the server. 



Notification Events 



Event 


Notification Type 


Performer Response past due 


Follow-up 


Performer Completion past due 


Follow-up 


Performer Completion comincr due 


Reminder 


Customer Response past due 


Follow-uo 


Act taken 


Act 



Return Value 

szNotif icationString will contain the notification string 

AWS TP OLLS TFQUEUE 

Description 
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This call returns the notification event to the STF 
Processor. If the notification event is "Act Taken", then 
the parameter IpTxId will contain the transaction Id of 
the Act. 

Syntax 

VOID FAR PASCAL AWSTPOLLSTFQUEUE (STRING 

szSTFProcessorName, LPIDEN lpBPTid, 
STRING szWFName, LP INT IpEvent, 
LPIDEN IpTxId, STRING szParticipantName, 
DATETIMESTRING szCompletionTime, 
DATETIMESTRING s zNot if icat ionTime , 
LPERRCODE iDError) 
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Warn a 




0 0 W 4* ^» W M 


szSTFProcessorName 


STRING 


STF Processor Name 


XpBF 1 ia 


T DTHTTM 


or xiu or l. ne cr 

instance which has 

some nutiiicaLion 
to be sent to the 
application. 


szWFNanie 


STRING 


WFName or tne wf 
instance 


IpEvent 


LP INT 


The Event Id is 
returned here . 


lpTxId 


LPIDEN 


Txld of the Act if 
Event is "Act 
Taken" 


szParticipantName 


STRING 


The participant's 
name is returned. 


s z Comple t i onT ime 


DATETIMESTRING 


Completion date & 
time is returned. 
This is the date 
and time when the 
event was due. For 
example, the 
instance when 
Performer Response 
is due. 


szNotif icationTime 


DATETIMESTRING 


Notification date & 
time is returned, 
mis is tne instant 
when this 
notification was 
placed in the STF 
oueue . 


IpError 


LPERRCODE 


Error code returned 
bv the server. 



Notification Events 


Event 


Notification Type 


Performer Response 
past due 


Follow-up 


Performer Completion 
past due 


Follow-up 


Performer Completion 
comina due 


Reminder 


Customer Response past 
due 


Follow-up 


Act taken 


Act 


Return Value 
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AWSTNDMAVAI LAB LE ACTS 

Description 

Returns number of available acts in the specified 
workflow for the role that the identity has in the 
workflow. 

Syntax 

VOID FAR PASCAL AWSTNUMAVAILABLEACTS (BPTID lBPTid, 
STRING szWFName, WFROLE WFRole, 
STRING szParticipantName, 
LP INT lpiCountPtr, LPERRCODE IpError) 



Parameters 



Nam* 


Type 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The 
Id of a previously 
instantiated BP . 


szWFName 


STRING 


The name of the 
workflow whose status 
is desired 


WFRole 


WFROLE 


The workflow role of 
the identity. 


s zPart icipantName 


STRING 


The participant for 
which the list of 
available acts is 
returned. 


lpiCountPtr 


LP INT 


Number of acts 
returned in the 
structure 


IpError 


LPERRCODE 


Error code returned 
bv the server. 



Return Value 

lpiCount is updated with the number of possible acts the 
Identity can take in the current workflow. 
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AWS TGETNUMAP P DATA 
Description 

Number of data fields are returned corresponding to 
the data fields bound to a workflow instance. 

Syntax 

VOID FAR PASCAL AWSTGETNUMAPPDATA (BPTID IBPTid, 

STRING szWFTName, WFROLE WFRole, STRING 
szParticipantName, LP INT IpiFieldsPtr, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The Id 
of a previously 
instantiated BP. 


szWFName 


STRING 


The name of the workflow 
from which to retrieve 
bound data . The 
transaction id should be 
null to retrieve 
business process bound 
data. 


WFRole 


WFROLE 


The WFRole of the 
Identity 


szParticipantName 


STRING 


The name of the person 
or identity requesting 
Application Data 
associated with the 
workflow . 


IpiFieldsPtr 


LP INT 


The number of bound data 
field retrieved. 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

lpiFields contains the number of fields retrieved. 



<II IRCTTTI ITF SHEET ( RULE 26) 



WO 94/18620 



135 



PCT/US94/01287 



AWS TNUKAVA I LABLEBP 

Description 

This function returns the number of BPs that 
satisfy a query. 

Syntax 

VOID FAR PASCAL 

AWSTNUMAVAILABLEBP (STRING szParticipantNa 
me, INT iBPStatus, LP I NT lpiCount, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


s zPar t ic ipantName 


STRING 


The participant for 
which the list of BPs is 
returned. 


iBPStatus 


INT 


Indicate the iBPStatus 
required. ACTIVE_BPS 
only can be selected or 
all BPs in the 
definition could be 
selected. 


IpiCount 


LP INT 


The number of BPs 
returned. 


IpError 


LPERRCODE 


Error code returned by 
the server. 



Return Value 

IpiCount, the number of workflows in the list. 
AWS TNUMACTHI STORY 

Description 

This call returns the number of Acts taken in the 
specified business process for a specific workflow. If 
workflow Id is NULL, then the history of the entire 
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business process, i.e., the number of all acts taken of 
all workflows is returned. 

Syntax 

VOID FAR PASCAL AWSTNUMACTH I STORY (STRING 

szParticipantName, BPTID lBPTid, STRING 
szWFName, LP INT IpiCount, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szParticipantName 


STRING 


The participant for 
which the list of 
Acts taken is 
returned. 


lBPTid 


BPTID 


Business Process id 


SzWFName 


STRING 


The workflow name 
for which the list 
of acts taken is 
returned. If no name 
is specified, i.e., 
the string is null, 
then the act history 
for the entire 
Business Process is 
returned. 


IpiCount 


LP INT 


Pointer to an 
integer. The 
function returns 
number of Acts 
returned. 


IpError 


LPERRCODE 


Error code returned 
bv the server. 



Return Value 

IpiCount, the number of Acts in the list. 

AWSTNUMQUERYWF 

Description 
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This function returns number of workflows that a 
participant is a member of as a specific Organization 
Role . 



Syntax 

VOID FAR PASCAL AWSTNUMQUERYWF (STRING szPart icipantName, 
STRING szOrgRole, STRING szBPName, 
STRING szStartDate, STRING szEnciDate, 
BOOL bPending, LP INT IpiCount, 
LPERRCODE IpError) 
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Parameters 



Name 


1 Type 


1 Description 


szParticipantNaxne 


STRING 


The participant for which the 
list of workflows is 
returned. 


szOrgRole 


STRING 


The organization role of the 
participants. Only workflows 
that have this specific 
OrgRole are selected. If 
OrgRole is specified as NULL 
then all workflows are 
selected regardless of the 
role 


szBPName 


STRING 


The workflows are selected 
only for the specified 
BPName. If BPName is NULL, 
then relevant workflows are 
selected regardless of the 
business process. 


szStartDate 


DATETIMESTRING 


StartDate for mierv, list 


szEndDate 


DATETIMESTRING 


End Date for query list. 
These dates specify a date 
range of due dates for which 
the list is constructed. If 
StartDate is NULL then the 
list includes all relevant 
workflows. 


bPending 


BOOL 


rouuiutj j.c* ikuc< uxien une 
list workflows includes only 

those WOrlcf lous yhprp ant-lnr* 

is pending. The workflows 
which needs to be initiated 
are also included. Otherwise 
it includes workflows where 
action is not pendino. 


lpiCount 


LP INT 


Returns the count of 
workflows selected. 


lpWFSnapShot 


LPWFSNAPSHOT 


Pointer to a list of selected 
workflows. Each workflow 
includes Business Process 
name & Id, Workflow name & 
Id, Customerld, Performerld, 
Completion and Reply Dates, 
Status and form name 


lpError 


LPERRCODE 


Error code returned by the 
server. 



Return Value 

lpiCount, the number of workflows in the list. 
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Customer 


Performer 


ContDletion requested 


Completion due 


Reply due to Performer 


Reply due to Customer 


Completion due by 
Performer 


Completion requested by 
Customer 


Reply due by Performer 


Reply due bv Customer 



Not all dates are returned, depending on the present 
state of the workflow the relevant dates are returned. 

AWSTSETCOS 

Description 

This function specifies the Conditions of 
Satisfaction (COS) associated with a workflow of a 
Business Process Instance. The COS is inserted as a 
series of memory blocks. This function requires the 
Business Process context and workflow to be setup before 
execution . 

Syntax 

VOID FAR PASCAL AWSTSETCOS (I DEN lBPTid, STRING szWFName, 
LPMEM lpCOS, LP I NT IpiMemBlockSize, ' 
INT iPositionNotify, LP ERKORCODE IpError) 
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Parameters 



Name 


Tvoe 


Descriction 

mm 10 *m 4i 


lBPTid 


BPTID 


Business Process 
Transaction Id. The Id 
or a previously 
instantiated BP. 


s zwr Name 


o 1 KXWb 


ine name or tne 
workflow. 


lpCOS 


LP MEM 


Pointer to a memory 
chunk which stores COS 
(BLOB) . 


IpiMemBlockSize 


LP INT 


Memory allocated for 
storing COS in bvtes . 


iPositionNotify. 


INT 


This variable identifies 
the first COS buffer, 
suDsequenc luo ourrers 
and the last one. It 
should be set to 0 to 
identify first buffer, 1 
to identify subsequent 
buffers . 


loError 


LP ERRORCOD E 


Error code returned. 



Return Value 



AWSTGETCOS 

Description 

The function gets the COS associated with the 
specified workflow of a Business Process. The COS is 
returned as a series of memory blocks. The memory block 
pointer and the block size allocated is passed to this 
function and the number of bytes actually written in the 
memory block is returned. For the first call, the 
contents of the variable pOffset must be set to zero (0) . 
This indicates the start of the memory block transfers. 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 

Syntax 
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VOID FAR PASCAL AWSTGETCOS (IDEN lBPTid, STRING SzWFName, 

LPMEM lpCOS, LP I NT lpiMemBlockSize, LP LONG 
lpOffset, LP ERRORCODE IpError) 



Parameters 



Name 


Type 


Description 


lBPTid 


BPTID 


Business Process 
Transaction Id. The Id of 
a previously instantiated 
BP. 


szWFName 


STRING 


The name of the workflow. 


lpCOS 


LPMEM 


Pointer to a memory chunk 
which stores COS (BLOB) . 


lpiMemBlockSize 


LP INT 


Memory allocated for 
stormQ luo in dvlcs * 


lpOffset 


LP LONG 


Initially, the caller 
must set this to zero. 
Each block transfer 
changes the value 
contained in this 
variable and the caller 
can only check the value 
returned here. This will 
be negative if end is 
reached. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Number of bytes actually written. 



Description 

This function returns the workflow transaction id of a 
workflow in a business process instance. 

Syntax 

VOID FAR PASCAL AWSTGETWFTID (IDEN lBPTid, STRING szWFName, 
LP IDEN lpWFTid, LP ERRORCODE IpError) 
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Parameters 



Name 


Type 


Description 


lBPTid 


BPTID 


Business Process Transaction 
Id. The Id of a previously 
instantiated BP. 


szWFName 


STRING 


The workflow name for which the 
transaction id is required 


IpWFTid 


LPIDEN 


The Transaction Id of the 
workflow is returned. 


lDError 


LPERRCODE 


Error code returned. 



Return Value 



Workflow Definitions API 
AWSDBEGINBP 

Description 

This call creates a new Business Process. The 
Business Process name is specified as a parameter. The 
Business Process name should be unique. If a Business 
Process with the same name is present, the current 
definition is overwritten as a new version. This takes 
place only if there are no active instances of the 
current business processes. The version number is 
maintained internally by the server. 

The AWSDBeginBP should be the first call when 
defining a business process and no other AWSDBeginBP call 
should be in progress. Every AWSDBeginBP has to be closed 
by a AWSDEndBP call. The AWSDEndBP should be the last 
call and ends the definition of a business process. 

AWSDBeginBP sets up a context for the business 
process and all subsequent calls require this context. 
The AWSDEndBP closes this context. 

Syntax 
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VOID FAR PASCAL AWSDBEGINBP (STRING szBPNante, IDEM lBPAditdn, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szBPName 


STRING 


The Business Process 
name . This name should be 
unique. If a business 
process- with the same 
name is present, the 
current definition is 
over written as a new 
version. There should be 
no active instances of 
the current definition 
for this to occur. 


IBP Admin 


IDEN 


The Identity of the 
person creating this 
business process. The 
Identity should have the 
rights to create business 
processes . 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDENDBP 

Description 

Close the currently open business process. A call 
to AWSDENDBP should be preceded by a call to AWSDBEGINBP. 

AWSDENDBP should be the last call when defining a 
business process . Every AWSDBEGINBP has to be closed by a 
AWSDENDBP. The AWSDENDBP should be the last call and ends 
the definition of a business process. The AWSDENDBP 
closes the context set up by AWSDBEGINBP. 
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Note: AWSDENDBP should be called only after a AWSDENDWF 
call has been made. 

Syntax 



VOID FAR PASCAL AWSDENDBP (LPERRCODE IpError) 

Parameters 



Name 


Type 


Description 


IpError 


LPERRCODE 


Error code returned . 



Return Value 

Error code is returned. 



AWSDDELETEBP 

Description 

Deletes a Business Process. The delete is 
successful only if the Business Process has no active 
instances in the activity database. This function is used 
to remove business processes no longer in use. This 
function is called only if the business process is not in 
progress. 

Syntax 

VOID FAR PASCAL AWSDDELETEBP (STRING szBPName, IDEN IBPAdmin, 
LPERRCODE IpError) 



CI IOCTITI ITC CUCCT /Of II P ld\ 



WO 94/18620 



145 



PCT/US94/01287 



Parameters 



Name 


Type 


Description 


szBPName 


STRING 


The name of the business 
process to delete. There 
should be no active 
instances for this 
BPName . 


lBPAamxn 


TnPKT 

lJJr*rJ 


me xu.enL.iuy ui uiic 
person deleting this 
business process. The 
Identity should have the 
rights to delete this 
business processes. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDSETBPBOUNDDATA 
Description 

Define the list of bound data fields associated with the 
business process. The field name, type, size, attributes 
and initial value, if any, are specified. 

Syntax 

VOID FAR PASCAL AWSDSETBPBOUNDDATA (INT iFields, 

LP BDF I E LD S TRUCT IpBDFieldStructPtr, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


iFields 


INT 


The number of 
fields to attach 
with the business 
process . 


lpBDFieldStructPtr 


LPBDF IELDSTRUCT 


A pointer to an 
array 

structures 
containing field 
name f type, size, 
attributes and 
initial value, if 
anv. 


IpError 


LPERRCODE 


Error code 
returned. 



Return Value 

Error code is returned. 

AWSDBEGINWF 

Description 

Creates a new workflow in a Business Process. The 
workflow name is specified as a parameter. The workflow 
name should be unique. If a workflow with the same name 
is present, then the context for this workflow is set up. 

The AWSDBEGINWF should be the first call when 
defining a workflow and no other AWSDBEGINWF call should 
' be in progress. Every AWSDBEGINWF has to be closed by a 
AWSDENDWF call. 

AWSDBEGINWF sets up a context for the workflow and 
all subsequent workflow calls require this context . The 
AWSDENDWF closes this context. 

Syntax 
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VOID FAR PASCAL AWSDBEGINWF ( STRING szWFName, LPERRCODE IpError) 



Name 




Description 


szWFName 


STRING 


The workflow name. This 
name should be uniaue. 


lDError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

AWSDENDWF 

Description 

Close the currently open workflow. A call to 
AWSDENDWF should be preceded by a call to AWSDBEGINWF. 

The AWSDENDWF should be the last call when defining 
a workflow. Every AWSDBEGINWF has to be closed by a 
AWSDENDWF call. The AWSDENDWF should be the last call and 
ends the definition of a workflow. The AWSDENDWF closes 
the context set up by AWSDBEGINWF. 

Syntax 



VOID FAR PASCAL AWSDENDWF (LPERRCODE IpError) 



Paraneters 


1 Name 1 


Type 


Description 


1 loError 1 


LPERRCODE 


Error code returned. 1 



Return Value 

Error code is returned. 

AWSDSETWFINFO 
Description 
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Specify workflow information. The workflow type, 
the organization role for the customer and performer, the 
time offsets for completion and reply are specified. This 
call must be made only after AWSDBEGINWF is called. 

Syntax 

VOID FAR PASCAL AWSDSETWFINFO (WFTYPE WFType, BOOL bCentralWF f 
IDEN lCustomer, IDEN IPerfonner, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


WFType 


WFTYPE 


This specifies the type 
of workflow, i.e. f 
Request or Offer or 
ATote. 


bCentralWF 


BOOL 


Flag to indicate if this 
workflow is the central 
workflow of the Business 
Process. This flag is 
TRUE if it is the 
central workflow, FALSE 
otherwise . 


ICustomer 


ORGROLE ID 


The Organization Role of 
the Customer. 


IPerformer 


ORGROLEID 


The Organization Role of 
the Performer, 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 



AWSDSETWrCYCLETIME 

Description 

Set the various cycle times associated with the 
workflow. Depending on the workflow type — Request or 
Offer, the response time for each act of the workflow i 
be specified. The table below enumerates the various 
times that can be stored. 
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Read table below as : 

<OrgRolel> must <Actionl> [after <OrgRole2> <Action2>] within 
time <t±ma> 



SI . 


OraRolel 


Actionl 


OrcrRole2 


Action2 


1 


Customer 


Reauest 






2 


Performer 


Respond 


Customer 


Reauest 


3 


Performer 


Complete 


Customer 


Reauest 


4 


Customer 


Respond 


Performer 


Declares 
completion 



SI 


OrgRolel 


Actionl 


OrgRole2 


Action2 


1 - 


Performer 


Offer 






2 


Customer 


Respond 


Performer 


Offer 


3 


Performer 


Complete 


Customer 


Acrreement 


4 


Customer 


Respond 


Performer 


Declares 
completion 



Note: The call must be made only after function 
AWSD SETWF INFO is called. 



Syntax 



VOID FAR PASCAL AWSDSETCYCLETIME (LPCYCLETIME IpCycleTime, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lpCycleTime 


LPCYCLETIME 


Pointer to an array of 
time offsets. Depending 
on the workflow type the 
array elements refer to 
different times are 
listed in the tables 
above. Since the number 
of cycle times for each 
workflow type is known, 
the count is not 
reouired. 


IpError 


LPERRCODE | 


Error code returned. 



Return Value 

Error code is returned. 



AWSDD I S ABLEWFACT 

Description 

Disable a set of workflow acts for a specific 
workflow role. By default all acts are enabled for a 
workflow. This call facilitates disabling specific acts. 
This call must be made only after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDDISABLEWFACT (WFROLE WFRole, INT iCount, 
LPACTINFO ActPtr, LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 




WFRole 


WFROLE 


The Workflow Role for 
which the acts are to be 
disabled. 




iCount 


INT 


The number of acts to 
disable . 




ActPtr 


LPACTINFO 


A pointer to an array of 
structures which 
contains the list of 
acts to disable. The 
number of acts is 
specified by parameter 
nCount 




IpError 


LPERRCODE 


Error code returned. | 



Return Value 

Error code is returned. 



AWSDSETACTUSERDEFINEDNAME 

Description 

Set the user-defined description for the workflow 
Acts. The list of acts and the equivalent user-defined 
names are provided. This call must be made only after a 
call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDSETACTUSERDEFINEDNAME (INT iCount, 
LPACTINFO ActPtr, LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


iCount 


INT 


The number of acts for 
which the user-defined 
name has been provided. 


ActPtr 


LP ACT INFO 


A pointer to an array of 
structures which 
contains the list of 
acts, i.e., Act Names 
and user-defined Names 
for the acts. 


IpError 


LPERRCODE 


Error code returned . 



Return Value 

Error code is returned. 

AWSDSETSTATEUSERDEFINEDNAME 

Description 

Set the User-defined description for the workflow 
states. The list of states and the equivalent user- 
defined names are provided. This call must be made only 
after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDSETSTATEUSERDEFINEDNAME (INT iCount, 

LP STATE INFO StatePtr, LPERRCODE IpError) 



Parameters 



Name | Type 


Description 


iCount 


INT 


The number of states for 
which the user-defined 
name has been provided. 


StatePtr 


LPSTATEINFO 


A pointer to an array of 
structures which 
contains the list of 
states, i.e., State 
Names and user-defined 
names for the states. 


lDError 


LPERRCODE 


Error code returned. 
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Return Value 

Error code is returned. 

AWSDSETACTSCRIPT 
Description 

Set the workflow script for an Act. The act and the 
script text are the parameters to this function. This 
call must be made only after a call to AWSDBEGINWF. 

Syntax 

VOID FAR PASCAL AWSDSETACTSCRIPT (ACT Act, LPMEM lpActScript, BOOL 
bScriptType, LP INT IpiMemBlockSize, 
INT iPositionNotify, ERR0RC0DE fiError) 

Parameters 
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Name 


Type 


Description 


Act 


ACT 


The type of act, e.g., 
Recruest , Agree , etc. 


IpActScript 


LPMEM 


The workflow script 
associated with the 
act. The script is 
executed when the 
corresponding act in 
the workflow is 
executed. 


bScriptType 


BOOL 


Scriot Tvoe is a 
Boolean flag which 
indicates whether the 
script is System 
generated or user 
aenerated. 


lpiMemBlockSize 


LP INT 


Size of the memory 
block in bvtes. 


iPositionNotify 


INT 


This variable 
identifies the first 
script buffer, 
subsequent buffers and 
the last one. It 

^hoillri ■ hp epf +■ r\ C\ t- r-\ 

identify first map 
buffer, 1 to identify 
subsequent map buffers 
and to 2 to indicate 
last buffer. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 



Act script added to the workflow. 

AWSDSETSTATESCRIPT 

Description 

Set the workflow script for a State. The state and the 
script text are the parameters to this function. This 
call must be made only after a call to AWSDBEGINWF, 

Syntax 
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VOID FAR PASCAL AWSDSETACTSCRIPT (STATE State, LPMEM IpStateScript , 
BOOL bScriptType, LP INT IpiMemBlockSize, 
INT iPositionNotify, LPERRORCODE IpError) 



Parameters 



Name 


Type 


Description 


State 


STATE 


The type of state, e.g., 
Init iate , Negot iat ion , 
Completing, Satisfied, 
etc • 


IpStateScript 


LPMEM 


The workflow script 
associated with the 
state. The script is 
executed when the 
workflow transits to the 
specified state. 


bScriptType 


BOOL 


Script Type is a Boolean 
flag which indicates 
whether the script is 
System generated or user 
crenerated . 


IpiMemBlockSize 


LP INT 


Size of the memory block 
in bytes . 


iPositionNotify 


INT 


This variable identifies 
the first script buffer, 
subsequent buffers and 
the last one. It should 
be set to 0 to identify 
first map buffer, 1 to 
identify subsequent map 
buffers and to 2 to 
indicate last buffer. 


loError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

State script added to the workflow. 
AWSDSETWFBOUNDDATAFIELDS 

% 

Description 
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Define the list of bound data fields associated with the 
workflow. The field name, type, size, default attributes 
and initial value, if any, are specified. 

Syntax 

VOID FAR PASCAL AWSDSETWFBOUNDDATAFIELDS (INT iFieldS, 
LPBDFIELDSTRUCT lpBDFieldStructPtr , 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


iFields 


INT 


The number of 
fields to attach 
with the 

workflow. •• • 


lpBDFieldStructPtr 


LPBDFIELDSTRUCT 


A pointer to an 
array of 
structures 
containing field 
name, type, size, 
default 

attributes and 
initial value, if 
any. 


IpError 


LPERRCODE 


Error code 
returned. 



Return Value 

The bound data fields are attached to the workflow. 



Error code is returned. 
AWSDSETWFBDFIELDATTRIBUTE 

Description 

Define the field attributes of bound data fields 
associated with the workflow. The field attributes, Read- 
only, Editable, Hidden and MustFill, may be specified for 
each Act and/or State for a specific workflow role. 
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A call to AWSDSETWFBDF IELDATTRIBUTE must be made 
only after calling AWSDSetWFBoundDataFields . 

Syntax 

VOID FAR PASCAL AWSDSETWFBDF IELDATTRIBUTE (INT iFields, 

LPWFMOMENTBDF I ELD S TRUCT IpWFMomentBDFieldS t ruct , 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


iFields 


INT 


The number of 






fields to 






attach with 






the workflow. 


IpWFMomentBDFieldS t ruct 


LP WFMOMENTBD FI ELD S TRUC T 


A pointer to 






an array of 






structures 






containing 






field name r 






Act or State, 






Workflow Role 






and 






attributes. 






The 






attributes 






are : Read- 






only, 






Editable, 






Hidden and 






MustFill. 


IpError 


LPERRCODE 


Error code 






returned. 



Return Value 

Error code is returned. 



The attributes of the bound data fields are attached to 
the workflow. 

AWSDSETFORMXNFO 

Description 



<-! IBCTITI ITC CUCCT /Pill F 0(t\ 



WO 94/18620 



158 



PCT/US94/01287 



Specify workflow form names for Customer, Performer 
and Observer. 

Syntax 

VOID FAR PASCAL AWSDSETFORMINFO (STRING szCusForm, 
STRING szPerForm, STRING szObsForm, 
STRING szlnitForm, LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szCusForm 


STRING 


Form name for Customer 
of workflow 


szPerForm 


STRING 


Form name for Performer 
of workflow 


szObsForm 


STRING 


Form name for Observer 
of workflow 


szlnitForm 


STRING 


Init form name of the 
workflow 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

Form names attached to the workflow 
AWSDSETFOLLOWUP 

Description 

Set up follow-up information associated with the 
workflow. The follow-up time offsets for Completion, 
Reply and Reminder are specified. 

A follow-up is sent after the Completion is past 
due. It is sent at the specified time interval after it 
is past due. If the recurring flag for Completion is set, 
then till Completion, follow-up messages are sent at 
every time interval specified. The maximum number of 
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times a follow-up notification is sent could be set using 
this call. 

A follow-up is sent after the Reply is past due. It 
is sent at the specified time interval after it is past 
due. If the recurring flag for Reply is set, then till 
Reply has been sent, follow-up messages are sent at every 
time interval specified. The maximum number of times a 
follow-up notification is sent could be set using this 
call . 

A reminder may be sent before Completion or Reply 
is due. The reminder is sent at a time interval specified 
before the event is due. Reminders may be disabled. A 
reminder is sent only once. 

Syntax 

VOID FAR PASCAL AWSDSETFOLLOWUP (BOOL bPCFUFlag, 

TIMEOFFSET PCFUOffset, BOOL bPCFURecur, 
INT iPCFUCount, BOOL bPRFUFlag, 
TIMEOFFSET PRFUOffset, BOOL bPRFURecur, 
INT iPRFUCount, 

BOOL bCRFUFlag, TIMEOFFSET CRFUOffset, 
BOOL bCRFURecur, INT iCRFUCount, 
TIMEOFFSET PCRemOf f set , BOOL bPCRemFlag, 
BOOL bActNotifyFlag, LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


bPCFUFlag 


BOOL 


Performer completion 
follow-up flaa. 


PCFUOffset 


TIMEOFFSET 


A follow-up message is 
sent at an interval, 
specified by PCFUOffset, 
after performer 
completion is oast due. 
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bPCFURecur 


BOOL 


If enabled, recurring 
notifications are sent 
at every PCFUOffset 
interval as many as 
PCFUCount times. 


iPCFUCount 


INT 


Number of times the 
follow-up notifications 
should be sent after 
performer completion is 
past due. 

If this parameter is not 
specified, and PCFUFlag 
is Set , uxien 
notifications are sent 
till performer 
completes . 


bPRFUFlag 


BOOL 


Performer response 
follow-up flacr 


XT I\£ UUIlScL 


1 IMEOr r SET 


A follow-up message is 
sent at an interval, 
specified by this 
parameter after 
Performer reply is past 
due . 


bPRFURecur 


BOOL 


If enabled, recurring 
notifications are sent 
at every PRFUOffset 
interval as many as 
PRFUCo unt t me s . If 
PRFUFlag is set TRUE and 
PRFUCount is not 
specified, then follow- 
up messages are sent 
until performer replies . 


iPRFUCount 


INT 


Number of times the 
follow-up notifications 
should be sent after 
performer Completion is 
past due. 

it tnis parameter is not 
specified, and PRFUFlag 
is set, then 
notifications are sent 
till performer 
completes . 


bCRFUFlag 


BOOL 


Customer response 
follow-up flaq 
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CRFUOffset 


TIMEOFFSET 


A follow-up message is 
sent at an interval, 
specified by this 
parameter after customer 
reDlv is Dast due 


bCRFURecur 


BOOL 


If enabled, recurring 
notifications are sent 
at every CRFUOffset 
interval as many as 
CRFUCount times. 


iCRFUCount 


INT 


Number of times the 
follow-up notifications 
should be sent after 
Customer Completion is 
past due . 

If this parameter is not 
specified, and CRFUFlag 
is set, then 
notifications are Qpnt 
till customer reolies. 


-PCRemOf fset 


TIMEOFFSET 


A reminder is sent at an 
interval PCRemOffset 

bpf nrp Pnmn 1 o+- ^ r**n >- 
uciuic uuui{jicuiun or 

Reolv is due. 


bPCRemFlag 


BOOL 


If this flag is enabled, 
reminders are sent. If 
disabled, no reminders 
are sent 


bActNotifyFlag 


BOOL 


Indicates notification 
status. If set to TRUE, 
notification is* enabled 
else if set to FALSE, it 
is disabled. 


loError 


LPERRCODE 


Error code returned. 



Return Value 

Error code is returned. 

Follow-up information attached to the workflow 
AWSDSETLINK 

Description 

Specify a in coming link to a workflow. For each 
link, the source workflow name, triggering and triggered 
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information is provided. Triggering information 
constitutes whether the link is anchored at an act or 
state and the act/state name. Triggered information 
constitutes whether the link terminates at an act or 
state and the act/state name. 

Note: AWSDSETLINK must be called only after all workflows 
have been created using AWSDBEGINBP. 

Syntax 

VOID FAR PASCAL AWSDSETLINK (STRING szFWFName f 

BOOL bFActOrState, ACTSTATEID FActState, 
STRING szTWFName, BOOL bTActOrState, 
ACTSTATEID TActState, LPERRCODE IpError) 



Parameters 



Nam© 


Type 


Description 


szFWFName 


STRING 


The source or "from" 
workflow name. The name 
of the workflow where a 
link is anchored. 


bFActOrState 


BOOL 


Flag to indicate if it is 
an Act or State link at 
source. 


FActState 


ACTSTATEID 


The act or state from 
where the link starts. 


szTWFName 


STRING 


The destination or "to" 
workflow name. The name 
of the workflow to which 
the link is tarcreted. 


bTActOrState 


BOOL 


Flag to indicate if it is 
an Act or State link at 
destination . 
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TActState 


ACTSTATE 


The act or state where 
the link ends. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Link information attached to the workflow 



Error code is returned. 
AWSDPUTMAP 

Description 

Associates a map file with the specified Business 
Process. The map file is inserted as a series of memory 
blocks. This function requires the business process 
context to be setup before execution. 

Syntax 

VOID FAR PASCAL AWSDPUTMAP (LPMEM lpMapMemPtr, LP INT 
lpiMemBlockSize, INT iPositionNotif y, 
LPERRCODE IpError) 



Parameters 



Name 


Tvpe 


Description 


lpMapMemPtr 


LPMEM 


Pointer to a memory block 
containincr map . 


lpiMemBlockSize 


LP INT 


Size of the memory block in 
bvtes . 


iPositionNotify 


INT 


This variable identifies 
the first map buffer, 
subsequent map buffers and 
the last one. It should be 
set to 0 to identify first 
map buffer, 1 to identify 
subseauent map buffers. 


IpError 


LPERRCODE 


Error code returned. 
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Return Value 

Error code is returned. 

AWSDGETMAP 

Description 

Get the map file associated with the specified 
Business Process. The map file is returned as a series 
of memory blocks . The memory block pointer and the block 
size allocated is passed to this function and the number 
of bytes actually written in the memory block is 
returned. Initially, the caller must pass a zero in the 
Offset variable to indicate start of the block transfers. 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 

Syntax 

VOID FAR PASCAL AWSDGETMAP (STRING szBPName, LP MEM 
IpMapMemPtr, LP I NT lpiMemBlockSize, 
LP LONG lpOffset, LPERRCODE IpError) 

Parameters 
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N&fflG 




DAseritst ion 

V O 0 W » *• • w ** 


s 2 BP Name 


STRING 


Business Process Name with 
which to associate the 
map . 


lpMapMemPtr 


LP MEM 


Pointer to a memory block 
where maD can be returned. 


lpiMemBlockSize 


LP INT 


Size of the memory block 
in bvtes . 


lpOf fset 


LP LONG 


Initially, the caller must 
set this to zero. Each 
block transfer changes the 
value contained in this 
varxaoxe ana tne caiier 
can only check the value 
returned here. This will 
be negative if end is 
reached. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Number of bytes actually written. 
Error code is returned. 
AWSDBPADDROLEASSIGNMENT 

Description 

Sets the Organization Role to Identity mapping at 
the Business Process level. 

Syntax 

void FAR PASCAL AWSDBPADDROLEASSIGNMENT ( IDEN lldentity, 
IDEN lOrgRoleld, LPERRCODE IpError) 

Parameters 
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Name 


Type 


Description 


lldentitv 


IDEN 


Organization Role id. 


lOrgRoleld 


IDEN 


Identity Id to be mapped 
with OrqRole 


IpError 


LPERRCODE 


Error code returned. 



Return Value 
AWSDWFADDROLEASSIGNMENT 

Description 

Sets the Organization Role to Identity mapping at 
the workflow level. 

Syntax 

void FAR PASCAL AWSDWFADDROLEASSIGNMENT { IDEN lldentity, 
IDEN lOrgRoleld, WFROLE WFRole, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lldentity 


IDEN 


Identity Id to be mapped 
with OrcrRole. 


lOrpRoleld 


IDEN 


Organization Role id. 


WFRole 


WFROLE 


Workflow role of the 
identity . 


loError 


LPERRCODE 


Error code returned. 



Return Value 



AWSDGETBPVERS ION 

Description 

Get the current BP Version for the specified BP 
name. The function returns the Business Process Version. 

Syntax 
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VOID FAR PASCAL AWSDGETBP VERSION (IDEN lldentity, STRING 
szBPName, 

LP INT lpiVersion, LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lldentity 


IDEN 


Identity Id to be mapped with 
OrqRole . 


szBPName 


STRING 


The name of the BP for which 
the version number is 
requested 


lpiVersion 


LP INT 


Pointer to an integer which 
holds the version number of BP 


IpError 


LPERRCODE 


Error code returned. 



Return Value 



AWSDGETLASTMODIFIEDDATE 
Description 

This function returns the last modified date of the 
Business Process specified. 

Syntax 

VOID FAR PASCAL AWSDGETLASTMODIFIEDDATE (STRING szBPName, 
LP DATE TIME pdtLastModif ied, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szBPName 


STRING 


The name of the BP for 
which the last modified 
date is recruested 


IpdtLastModif ied 


LPDATETIME 


The pointer to the 
DATETIME type which 
holds the last modified 
date of the Business 
Process . 


IpError 


LPERRCODE 


Error code returned. 



Return Value 
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AWSDSETBPNOTXFXCATXON 

Description 

The notification string for the event is set with 
respect to the current BP context . 

Syntax 

void FAR PASCAL 

AWSDSETBPNOTIFICATION (EVENT Notif icationE 
vent f STRING szNotif icationString, 
LPERRCODE IpError) 

Parameters 



Name 



Not i f icat i onE ven t 



T YP e 



EVENT 



Description 



This parameter 
notifies the event 



szNotif icationString 



STRING 



The notification 
string . 



IpError 



LPERRCODE 



Error code returned. 



Notification Events 




Event 


Notification 
Type 


Performer Response past due 


Follow-up 


Performer Completion past due 


Follow-up 


Performer Completion comina due 


Reminder 


Customer Response past due 


Follow-up 


Act taken 


Act 



Return Value 
AWSDSETWFNOTIFICATION 

Description 

The notification string for the event is set with 
respect to the current WF context . 



Syntax 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18(20 



169 



PCT/US94/01287 



void FAR PASCAL 

AWSDSETWFNOTIFICATION (EVENT Notif icationE 

vent, STRING szNotif icationString, 

LPERRCODE IpError) 
Parameters 



Nam© 


Type 


Description 


Not i f i cat ionE vent 


EVENT 


This parameter 
notifies the event 


szNotificationString 


STRING 


The notification 
strinq . 


IpError 


LPERRCODE 


Error code returned. 


Notification Events 


Event 


Notification Tvoe 


Performer Response past due 


Follow-up 


Performer Completion past due 


Follow-up 


Performer Completion comina due 


Reminder 


Customer Response past 


due 


Follow-up 


Act taken 


Act 


Return Value 






AWSDSETCOS 






Description 







This function specifies COS associated with a 
workflow of a Business Process. The COS is inserted as a 
series of memory blocks. This function requires the 
Business Process context and workflow to be setup before 
execution . 



Syntax 

VOID FAR PASCAL AWSDSETCOS (LPMEM lpCOS, 
LP INT lpiMemBlockSize, 

INT iPositionNotify, LPERRORCODE IpError) 
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Parameters 



Name 


Type 


Description 


lpCOS 


LPMEM 


Pointer to a memory 
chunk which stores COS 
(BLOB) . 


lpiMemBlockSize 


LP INT 


Memory allocated for 
storincy COS in bvtes . 


iPositionNotify 


INT 


This variable 
identifies the first 
COS buffer, subsequent 
^uo Duiiers ana tne 
last one. It should be 
set to 0 to identify 
first buffer, 1 to 
identify subsequent 
buffers and to 2 to 
indicate last buffer. 


loError 


LPERRORCODE 


Error code returned. 1 



Return Value 



AWSDGETCOS 

Description 

The function gets the COS associated with the 
specified workflow of a Business Process. The COS is 
returned as a series of memory blocks. The memory block 
pointer and the block size allocated is passed to this 
function and the number of bytes actually written in the 
memory block is returned. For the first call, the 
contents of the variable pOffset must be set to zero (0) . 
This indicates the start of the memory block transfers. 
The caller will be notified with a negative value in the 
Offset variable to indicate end of the block transfers. 

Syntax 

VOID FAR PASCAL AWSDGETCOS (STRING szBPName, 
STRING szWFName, LPMEM lpCOS, 
LP INT lpiMemBlockSize, LP LONG lpOffset, 
LPERRORCODE IpError) 
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Parameters 



Name 


Type 


Description 


szBPNanie 


STRING 


Business Process Name 


szWFName 


STRING 


Workflow Name 


lpCOS 


LPMEM 


Pointer to a memory chunk which 
stores COS (BLOB) . 


IpiMemBlock 
Size 


LP INT 


Memory allocated for storing 

COQ in hvt^Q 

\— » .1.1. J i^yL.CO » 


lpOffset 


LP LONG 


Initially, the caller must set 
this to zero. Each block 
transfer changes the value 
contained in this variable and 
the caller can only check the 
value returned here. This will 
be necrative if end is reached. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 

Number of bytes actually written. 



AWSDWFADDOBSROLE 

Description 

Sets the Observer Organization Role(s) at the 
workflow level. 

Syntax 

VOID FAR PASCAL AWSDWFADDOBSROLE (IDEN lOrgRoleld, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lOrqRoleld 


IDEN 


Oraanization Role id. 


IpError 


LPERRCODE 


Error code returned. 



Return Value 



AWSDWFDELETEOBSROLE 
Description 
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Deletes the Observer Organization Role(s) at the 
workflow level. 

Syntax 

VOID FAR PASCAL AWSDWFDELETEOBSROLE (IDEN lOrgRoleld, 



LPERRCODE IpError) 
Parameters 



Name 

lOrcrRoleld 


Type 


Description 


IDEN 


Oraanization Role id. 


IpError 


LPERRCODE 


Error code returned . 



Return Value 

Names and Routings API 
AWSNADDORGROLE 



Description 

Add a new Organization Role name to the server. 
This name should be unique. The Organization Role Id is 
returned. 

Syntax 

VOID FAR PASCAL AWSNADDORGROLE (STRING szOrgRoleName, 
LP IDEN lpOrgRoleld, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Typo 


Description 


szOrgRoleName 


STRING 


The Organization Role 
name to add to the 
server. The name should 
be unique. 


lpOrgRoleld 


LPIDEN 


The OrgRoleld is 
returned on successful 
addition of Organization 
role name to the server. 


lAuthorize Identity 


IDEN 


Identitv of th^ npr^nn 

adding the name to the 
server. The Identity 
must be authorized to 
add names. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

The Organization Role Id, OrgRoleld is returned by the 
function. 



AWSNINQUIREORGROLE 
Description 

Inquire if a specified Organization Role is present 
in the server database. If present, the Organization Role 
Id is returned. 

Syntax 

VOID FAR PASCAL AWSNINQUIREORGROLE (STRING szOrgRoleName, 
LPIDEN lpOrgRoleld, 
IDEN lAuthorize Identity, 
LPERRCODE IpError) 
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Parameters 



ti a ul 6 




Tiftflrriiat ion 

V S) W 4> ^ p» t» ^ W Aft 


lGroupId 


IDEN 


The Group Id of the 
group from which to 
remove GroupMember. 


lGroupMemberld 


IDEN 


The Identity of the 
person being removed 

irom une broup/ 
identified by Group Jd. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person deleting. The 
person must have the 
authority to delete. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

The Identity is removed from the group. 



AWSNGETGROUPLIST 

Description 

Determine the list of groups an Identity is a 
member of. This function returns a list and a count. 

Syntax 

VOID FAR PASCAL AWSNGETGROUPLIST ( IDEN lGroupMemberld, 
LP INT lpiCount, BOOL bFileOrMemory , 
LP GENERAL INFO lpGroupInf oArray , 
STRING szFileName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


1 G r oupMemb e r I d 


IDEN 


The Identity of the 
person being 
assigned to the 
Group, identified 
bv Groupld. 


lpiCount 


LP INT 


Pointer to a 
counter. The number 
of groups 
GroupMember is a 
member of . This 
value is returned. 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory mode 
of receipt of data 
from the API . 


lpGroupInf oArray 


LPGENERALINFO 


The list of groups 
GroupMexnber is a 
member of . For each 
group, the Group Id 
and Group Name are 
returned. A pointer 
to an array of 
Group Ids and Group 
Names is returned 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


1 Aut horize Identity 


IDEN 


The Identity of the 
person Inquiring, 
The person must 
have the authority 
to Inauire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

The count of groups and a list of Group Id and 
GroupName returned . 



AWSNGETGROUP MEMBERS 
Description 
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Get the list of all members in a group. The 
Identity of each member in a group is returned. The 
IdentityName is also returned. 



Syntax 

void FAR PASCAL AWSNGETGROUPMEMBERS (IDEN IGroupId, 
LP INT IpiCount, BOOL bFileOrMemory, 
LP GENERAL I NFO IpMemberlnf oArray , 
STRING szFileName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lGroupId 


IDEN 


The Groupld of 
the group from 
which to retrieve 
list of members . 


IpiCount 


LP INT 


Pointer to 
nCount, the 
number of members 
in the Group. 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory 
mode of receipt 
of data from the 
API . 


IpGenerallnfoArray 


LPGENERAL INFO 


A list of members 
in the group is 
returned. The 
list contains the 
Identity Id and 
IdentityName of 
each member. 
1 pGenera 1 InfoArra 
y is a pointer to 
an arrav. 


szFileName 


STRING 


File name where 
the API should 
deposit the 
results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of 
the person 
inquiring. The 
person must have 
the authority to 
inouire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

List of members returned. 



AWSNADD ROLE AS S I GNMENT 

Description 

Assign an Identity or a Group to an Organization 
Role. The Identity or all members of the group are 
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assigned the specific Organization Role. Follow-up 
flags to enable/disable Reminders and Follow-up 
messages may be specified here. If an assignment is 
already present then the new Follow-up flags are 
assigned. 

Syntax 

VOID FAR PASCAL 

AWSNADDROLEASSIGNMENT (BOOL bGroupOrlderi 

tity, I DEN lAssigneeld, 

IDEN lOrgRoleld, 

IDEN lAuthorizeldentity, 

LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


bGroupOr Ident it y 


BOOL 


Flag to indicate if 
Assignee is an identity 
or a Group. If 
GroupOr Identity is 
TRUE, then Assignee 
contains a Groupld, 
otherwise it is an 
Identity. 


lAssignee 


IDEN/ IDEN 


The id of the Identity 
or Group being assigned 
the Organization Role. 
If a Group is being 
assigned, then all 
members of the group 
inherit the Role 


lOrgRoleld 


ORGROLEID 


The Organization Role 
the Identity or Group 
will be assiqned. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person assigning role. 
The person must have 
the authority to make 
this assicrnment. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

Identity/Group assigned Organization Role. 
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AWSNINQUIREROLE AS S I GNMENT 

Description 

Verify if a specific Identity is associated with 
an Organization Role, The function returns a flag. The 
Identity is first checked if it is associated with the 
Organization Role. If no association is found, then a 
check is made if an association exists with any of the 
groups Identity is a member of. 

Syntax 

BOOL FAR PASCAL 

AWSNINQUIREROLEASSIGNMENTEXTENDED (BOOL 

bGroupOr Identity, IDEN lAssignee, 

IDEN lOrgRoleld, 

IDEN lAuthorizeldentity, 

LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


bGr oupOr I dent it y 


BOOL 


Flag to indicate if 
Assignee is an identity 
or a Group, If 
GroupOrldentlty is 
TRUE, then Assignee 
contains a Groupld, 
otherwise it is an 
Identity. 


lAssignee 


IDEN 


The id of the Identity 
beina inauired. 


lOrgRoleld 


IDEN 


The Organization Role 
being verified for the 
Assiq-nee. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person inquiring the 
association • The person 
must have the authority 
to incruire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 
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The function returns a TRUE if the association is 
present, FALSE otherwise. If the association exists 
then the Follow-up flags are also returned. 

AWSNDELETEROLEASSIGNMENT 

Description 

Disassociate an Identity or Group from a specific 
Organization Role. The Identity or all members of the 
group cease to be associated with the Organization 
Role % 

Syntax 

VOID FAR PASCAL 

AWSNDELETEROLEASSIGNMENT (BOOL bGroupOrl 
dent it y, IDEN lAssignee, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


bGroupOr Identity 


BOOL 


Flag to indicate if 
Assignee is an Identity 
or a Group. If 
GroupOr Identity is 
TRUE, then Assignee 
contains a Groupld, 
otherwise it is an 
Identity. 


lAssignee 


IDEN 


The id of the Identity 
or Group being 
disassociated. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person deleting the 
association. The person 
must have the authority 
to delete. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 
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AWSNGETROLELIST 

Description 

Determine the list of Roles that are assigned to 
a specific Identity or Group. This function returns a 
list of Organization Roles and a count. 

Syntax 

VOID FAR PASCAL AWSNGETROLELIST (BOOL bGroupOrldentity , 
IDEN lAssignee, LP INT lpiCount, 
BOOL bFileOrMemory, 
LP GE NERAL I NFO lpOrgRolelnf oArray , 
STRING szFileName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


bGroupOr Identity 


BOOL 


Flag to indicate 
if Assignee is a 
Identity or a 
Group. If 

GroupOr Identity is 
TRUE, then 
Assignee contains 
a Groupld, 
otherwise it is 


lAssignee 


IDEN 


The id of the 
Identity or Group 
beincr inquired. 


lpiCount 


LP INT 


Pointer to a 
counter . The 
number of 

Oroani zat ion Role**? 
an Identity/Group 
is assicned . 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory 
mode of receipt of 
data from the API. 


IpOrgRolelnfoArray 


LPGENERALINFO 


The list of 
Organization Roles 
Assignee is 
assigned to. For 
each Role, the 
OrgRole, Follow-up 

xia^o cuiu . 

description are 
returned. A 
pointer to a list 
of OrgRoles and 
description is 
returned . 


szFileName 


STRING 


F i 1 f* nam© w*na*"o 

the API should 
deposit the 
results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of 
the person 
Inquiring . The 
person must have 
the authority to 
Incruire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



1B3 



PCT/US94/01287 



Return Value 

List and Count returned. 

AWSNGET IDENAS SIGNEELI ST 

Description 

Determine the list of Identities that are 
assigned to a specific Organization Role. This 
function returns a list of Identities and their names. 

Syntax 

VOID FAR PASCAL 

AWSNGETIDENASSIGNEELIST (IDEN lOrgRoleld 

, LP INT lpiCount, BOOL bFileOrMemory , 

LPASSIGNEE lpldenlnf oArray, 

STRING szFileName, 

IDEN lAuthorizeldentity, 

LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lOrgRoleld 


IDEN 


The Organization Role 
for which list of 
Assignees is being 

returncu • 


lpiCountPtr 


LP INT 


Pointer to a counter. 
The number of 
Assignees (Identities 
or i?roupsj associateu 
with the Organization 
Role OraRole 


bFileOrMemory 


BOOL 


Flag to indicate File 
or Memory mode of 
receipt of data from 
the API. 


lpldenlnf oArray 


LP ASSIGNEE 


List of identities who 
are associated with a 
specific organization 
role. The bNotify flag 
associated with the 
Identity is also 
returned. A pointer to 
a list is returned. 


szFileName 


STRING 


File name where the 
API should deposit the 
results of the call if 
tne r±ag df ileOrMemory 
is ITS FILE. 






person requesting the 
list . The person must 
have the authority to 
incruire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

List and Count returned. 



AWSNGETGROUPASSIGNEELIST 

Description 

Determine the list of Identities and Groups that 
are assigned to a specific Organization Role. This 
function returns a list of Identities and Group and 
their names . 

Syntax 
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VOID FAR PASCAL 

AWSNGETGROUPASSIGNEELIST (IDEN lOrgRolel 

d, LP INT lpiCount, BOOL bFileOrMemory, 

LPGENERALINFO lpGroupInf oArray , 

STRING szFileName, 

IDEN lAuthorize Identity, 

LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lOrgRoleld 


ORGROLEID 


The Organization 
Role for which list 
of Assignees is 
beinq returned. 


lpiCountPtr 


LP INT 


Pointer to a 
counter. The number 
of Assignees 
{Identities or 
Groups) associated 
with the 

Organization Role 
OrQRole 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory mode 
of receipt of data 
from the API . 


lpGroupInfoArray 


LPGENERALINFO 


List of groups who 
are associated with 
a specific 
organization role. 
A pointer to a list 
is returned. 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of the 
person requesting 
the list . The 
person must have 
the authority to 
inouire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 
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List and Count returned. 
AWSNCREATESTFDEFN 

Description 

Create an entry in the STF Processor table. The 
processor name and the network address is maintained. 
The STF Processor Id is returned. 

Syntax 

VOID FAR PASCAL 

AWSNCREATESTFDEFN (STRING szSTFProcName, 
STRING szNet Address, 
LPIDEN IpSTFProdd, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


szSTFProcName 


STRING 


The name of the STF 
Processor. 


szNet Address 


STRING 


The network address of 
the location of the STF 
Processor. The 
processor must exist 
for this call to return 
successfully. 


IpSTFProdd 


LPIDEN 


The STFProc Id is 
returned. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person Creating the STF 
definition. The 
identity must be 
authorized to create 
STF definition. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

STFProcessorld returned. 
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AWSNGETSTFDEFN 

Description 

Get the STF definition from the STF Processor 
table for a specific STF Processor Id. The processor 
name and the network address are returned. 

Syntax 

VOID FAR PASCAL AWSNGETSTFDEFN ( IDEN ISTFProcId, 
STRING szSTFProcName, 
STRING szNetAddress, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


ISTFProcId 


IDEN 


The STF Processor Id. 


szSTFProcName 


STRING 


The name of the STF 
Processor is returned. 


szNetAddress 


STRING 


The network address, of 
the location of the STF 
Processor is returned. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person inquiring the 
STF definition. The 
identity must be 
authorized to inauire. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

STFProcessor name and net address returned. 
AWSNDELETESTFDEFN 

Description 

Delete the STF definition from the STF Processor 
table for a specific STF Processor Id. 

Syntax 



CI IDCTIT! itc SMPFT /RULE 26) 



WO 94/18620 



188 



PCT/US94/01287 



VOID FAR PASCAL AWSNDELETESTFDEFN ( IDEN STFProcId, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


STFProcId 


IDEN 


The STF Processor Id. 


lAuthorizeldentity 


IDEN 


The Identity of the 
person deleting the 
STF definition. The 
identity must be 
authorized to delete. 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

STFProcessor name and net address returned. 



AWSNGETNUMGROUPLIST 



Description 

Determine the number of groups an Identity is a 
member of. This function returns a count. 

Syntax 

VOID FAR PASCAL 

AWSNGETNUMGROUPLIST (IDEN lGroupMemberld 
, LP INT lpiCount, BOOL bFileOrMemory, 
LPGENERALINFO lpGroupInf oArray , 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lGroupMemberld 


IDEN 


The Identity of the 
person being 
assigned to the 
Group, identified 
bv Groupld. 


lpiCount 


LP INT 


Pointer to a 
counter. The number 
of groups 
GroupMember is a 
member of. This 
value is returned. 


bFileOrMemory 


BOOL 


Flag to indicate 
File or Memory mode 
of receipt of data 
from the API. 


lpG r oup I n f o Ar r a y 


LPGENERALINFO 


The list of groups 
GroupMember is a 
member of. For each 
group, the Group Id 
and Group Name are 
returned. A pointer 
to an array of 
Group Ids and Group 
Names is returned 


szFileName 


STRING 


File name where the 
API should deposit 
the results of the 
call if the flag 
bFileOrMemory is 
ITS FILE. 


lAuthorize Identity 


IDEN 


The Identity of the 
person Inquiring . 
The person must 
have the authority 
to Inauire. 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

The count of groups is returned. 



AWSNGETNUMGROUPMEMBERS 

Description 

Get the number of all members in a group. 

Syntax 
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id FAR PASCAL AWSNGETNUMGROUPMEMBERS { IDEN lGroupId, 
LP INT lpiCount, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 



Parameters 



Name 


Type 


Description 


lGroupId 


IDEN 


The Groupld of the 
group from which to 
retrieve list of 
members . 


lpiCount 


LP INT 


Pointer to nCount, 
the number of 
members in the 
Grout) . 


lAuthorizeldentity 


IDEN 


The Identity of the 
person inquiring. 
The person must 
have the authority 
to incruire . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

Number of meinbers returned. 



AWSNGETNUMROLELXST 

Description 

Determine the number of Roles that are assigned 
to a specific Identity or Group. 

Syntax 

VOID FAR PASCAL 

AWSNGETNUMROLEL I ST (BOOL bGroupOrldent it 
y, IDEN lAssignee, LP I NT lpiCount, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


bGroupOr Identity 


BOOL 


Flag to indicate if 
Assignee is a Identity 
or a Group. If 
GroupOr Identity is 
TRUE, then Assignee 
contains a Groupld, 
otherwise it is 


lAssignee 


IDEN 


The id of the Identity 
or Group being 
inouired. 


lpiCount 


LP INT 


Pointer to a counter. 
The number of 

^iuciniM(*uivii au -l o an 

Identity /Group is 
assicrned . 


lAuthorizeldentity 


IDEN 


The Identity of the 
person Inquiring. The 
person must have the 
authority to Inauire. 


.IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 



AWSNGETNUMIDENASSIGNEELIST 

Description 

Determine the number of Identities that are 
assigned to a specific Organization Role. 

Syntax 

VOID FAR PASCAL 

AWSNGETIDENASSIGNEELIST ( IDEN lOrgRoleld 

, LP INT lpiCount, 

IDEN lAuthorizeldentity , 

LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


lOrgRoleld 


IDEN 


The Organization Role 
for which list of 
Assignees is being 
returned . 


IpiCountPtr 


LP INT 


Pointer to a counter . 
The number of Assignees 
(Identities or Groups) 
associated with the 
Organization Role 
OrqRole 


lAuthorize Identity 


IDEN 


The identity or trie 
person requesting the 
list. The person must 
have the authority to 
inauire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 



AWSNGETNUMGROUP AS S IGNE ELIST 

Description 

Determine the list of Identities and Groups that 
are assigned to a specific Organization Role. This 
function returns a list of Identities and Group and 
their names . 

Syntax 

VOID FAR PASCAL 

AWSNGETNUMGROUP ASSIGNEELIST ( IDEN lOrgRo 
leld, LP INT lpiCount, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


* Type 


Description 


lOrgRoleld 


ORGROLEID 


The Organization Role 
for which list of 
Assignees is being 
returned. 


lpiCountPtr 


LP INT 


Pointer to a counter. 
The number of 
Assignees (Identities 
or Groups) associated 
with the Organization 
Role OrQRole 


LAuthorizeldentity 


IDEN 


The Identity of the 
person requesting the 
list. The person must 
have the authority to 
incruire . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 



Schedule API 

The following is a description of the functions 
performed by the components of the Schedule API for 
implementation of the Schedule API. 
AWSSPUTBPSCHEDULE 

Description 

The schedule information associated with a 
business process is stored in the server. The time 
when the business process needs to be initiated and 
recurrence information are stored. 

Syntax 

VOID FAR PASCAL AWSSPUTBPSCHEDULE (STRING szBPName, 
DATETIMET UnitTime, 
DATETIMET IRecurPeriod, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


szBPName 


STRING 


Business Process name. 
The business process 
for which schedule 
information needs to 
be attached. 


UnitTime 


DATETIMET 


The first time when 
the business process 
is initiated. If this 
is not specified, then 
the business process 
is not initiated by 
the Scheduler. 


IRecurPeriod 


DATETIMET 


If specified, the 
business process is 

nil Lxaucu ct u cvciy 

RecPeriod interval . 


lAuthorize Identity 


IDENTITY 


Identity of the person 
placing scheduler 
reouest . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

Schedule information stored in the server. 
AWSSGETBPSCHEDULE 

Description 

The schedule information associated with a 
business process is returned. The initiation time and 
recurrence information are returned. 

Syntax 

VOID FAR PASCAL AWSSGETBPSCHEDULE (STRING szBPName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 


Description 


szBPName 


STRING 


Business Process Name, 
xne Dusiness process 
for which schedule 
information is 
returned . 


lAuthorize Identity 


IDEN 


Identity of the person 
requesting scheduler 
information . 


IpError 


LPERRCODE 


This is set to a non- 
zero value on error 



Return Value 

Schedule information, initiation time and recurring 
period returned. 

AWSSDELETEBP SCHEDULE 

Description 

The schedule information associated with a 
business process is removed. However, currently active 
instances of the business process remain unaffected. 

Syntax 

VOID FAR PASCAL AWSSDELETEBP SCHEDULE (STRING szBPName, 
IDEN lAuthorizeldentity, 
LPERRCODE IpError) 
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Parameters 



Name 


Type 




szBPName 


STRING 


Business Process 
Name. The business 
process for which 
schedule 

information has to 
be deleted. 


lAuthorize Identity 


IDEN 


Identity or trie 
person deleting 
scheduler 
information . 


IpError 


LPERRCODE 


This is set to a 
non-zero value on 
error 



Return Value 

Schedule information deleted. 



Server Administration API 

The following details the methods of workflow 
server manager (WSM) classes, which are also the 
internal APIs that are used to achieve the 
functionality of the workflow server manager . 

AWSSt art Server 

This call starts the workflow server reading the 
configuration information from a parameter file. The 
server can be shutdown by issuing AWSStopServer call. 
The API establishes a session of the workflow server 
with the underlying database server and starts the 
workflow server operations. 

Syntax 

void FAR PASCAL AWSStartServer 

Parameters 

None . 
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Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSStopServer 

This call stops the workflow server operations. 
The transaction manager No requests from client 
applications are processed after this call is made. 

Syntax 

void FAR PASCAL AWSStopServer 

Parameters 

None . 

Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWS Grant 

This call grants the specified privileges to the 
user by creating an authorization record for the user, 
object and the action in the privileges table. The 
granted privileges can be revoked by calling AWSRevoke 
function. 

Syntax 

void FAR PASCAL AWSGrant ( IDENUserld, eObject, eAction 
) 
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Parameters 



Name 


Type 


Description 


IDENUserld 


IDENTITY 


Id of the user who is 
being granted with the 
Drivileae . 


eOb ject 


OBJECT 


Object on which 
privilege is being 
aranted. 


e Act ion 


ACTION 


Action for which the 
privileges are being 
errant ed. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSRevoke 

This call revokes the privileges granted to the 
user with a previous call to AWSGrant by deleting the 
record for user, object, and action form authorization 
table . 

Syntax 

void FAR PASCAL AWSRevokePrivilege ( IDENUserName, 
eObject, e Act ion ) 



Parameters 



Name 


Type 


Description 


IDENUserName 


IDENTITY 


Id of the user whose 
privilege is being 
revoked. 


eObject 


OBJECT 


Object on which 
privilege is being 
revoked. 


e Act ion 


ACTION 


Action for which the 
privileges are being 
revoked . 
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Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSAbortBP 

This call marks specified business process 
instance in transaction database as aborted by 
changing the status of BP Transaction instance class 
(TxBPInstance) . 

Syntax 

void FAR PASCAL AWSAbortBP ( IpszBPTId ) 



Parameters 



Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
aborted. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSDeleteBP 

This call deletes specified business process 
instance from transaction database. 

Syntax 

void FAR PASCAL AWSDeleteBP ( IpszBPTId ) 
Parameters 
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Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
deleted from Transaction 
database . 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSSuspendBP 

This call suspends the execution of specified 
business process instance by changing the status of BP 
transaction instance class (TxBPInstance) . No 
transactions can take place on the business process 
till it is restarted again by a call to AWSRestartBP . 

Syntax 

void FAR PASCAL AWSSuspendBP ( IpszBPTId ) 



Parameters 



Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
suspended. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSResumeBP 
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This call restarts specified business process 
instance in transaction database, suspended previously 
by a call to AWSSuspendBP . 

Syntax 

void FAR PASCAL AWSResumeBP ( IpszBPTId ) 



Parameters 



Name 


Type 


Description 


IpszBPTId 


STRING 


Instance of the Business 
Process that has to be 
restarted. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSArchiveBP 

This call archives a business process or all 
completed business processes on the specified media. 
The archived business processes are deleted from the 
database. This function will in turn use AWSBackup 
function for backing up the data on a different media. 

Syntax 

void FAR PASCAL AWSArchiveBP < IpszBPName, 
eArchiveMedia, ArchiveTime, ArchiveDate ) 

Parameters 

None . 
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Name 


Type 


Description 


IpszBPName 


STRING 


The Business Process 
name. This name should 
be unique. If a business 
process with the same 
name is present, the 
curreni Qeiininon xs 
over written as a new 
version. There should be 
no aCiive insLanccs ox 
the current definition 


eArchiveMedia 


ENUM 


The media to which the 
business process is to 
be archived. 


ArchiveDate 


TIME 


The date on which 
archivina is done. 


AcrhiveTime 


TIME 


The time on which 
archivina is done. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSListAvailBPs 

This call lists all the business processes by 
running through the definitions database to find out 
all instances of BP definition class (DfBP) . 

Syntax 

void FAR PASCAL AWSListAvailBPs 

Parameters 

None . 

Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
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AWSListActiveBPs 

This call lists all the active business processes 
by running through the transactions database and 
finding out all instances of TxBPInstances that have 
status as 'Active'. 

Syntax 

void FAR PASCAL AWSListActiveBPs 

Parameters 

None. 

Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSDeleteBPDef inition 

This call deletes the definition of specified 
business process from the definitions database by 
using VDB method DeleteBP of class Df BP . 

Syntax 

void FAR PASCAL AWSDeleteBPDef inition ( IpszBPDId ) 



Parameters 



Name 


Type 


Description 


IpszBPDId 


STRING 


Id of the Business 
Process that has to be 
deleted from definitions 
database . 
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Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

AWSLi s t Ac t ive WF 

This call lists all active workflows in the 
specified business process by using VDB method ListBP 
of class TxBP Instance . 

Syntax 

void FAR PASCAL AWSListAct iveWF ( IpszBPName ) 



Parameters 



Name 


Type 


Description 


IpszBPName 


STRING 


Name of the Business 
Process whose active 
workflows are to be 
listed. 



Return Value 

Success — AWSError ~ 0 

Failure — AWSError <> 0 

AWSRegister 

This call registers the new STF Processor name in 
the Names and Routing database by using VDB method 
CreateSTFDefn. 

Syntax 

void FAR PASCAL AWSRegister ( IpszSTFProcessorName ) 

Parameters 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



205 



PCT/US94/01287 



Name 


I Type 


I Description 


IpszSTFProcessorName 


1 STRING 


1 The STF Processor name. 


Return Value 






Success — AWSError - 


0 





Failure — AWSError <> 0 
AWSDer agister 

This call deregisters an STF Processor name from 
the server Names and Routing database, previously 
registered by AWSRegister call. 

Syntax 

void FAR PASCAL AWSDeregister ( IpszSTFProcessorName ) 



Parameters 



1 Name 


Type 


Description 1 


1 loszSTFProcessorName 


STRING 


The STF Processor name . 1 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSCheck 

This call checks a particular workflow server 
database for consistency and integrity. The API will 
in turn use appropriate database APIs to provide the 
functionality. 

Syntax 
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void FAR PASCAL AWSCheck 

Parameters 

None . 

Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWS Index 

This call reindexes a particular workflow server 
database. The API will in turn use appropriate 
database APIs to achieve the functionality. 

Syntax 

void FAR PASCAL AWS Index 

Parameters 

None . 

Return Value 

Success — AWSError *= 0 

Failure — AWSError <> 0 

AWSReorganize 

This call reorganizes a particular workflow 
server database, to permanently remove the records 
marked for deletion. The API will in turn use 
appropriate database APIs to achieve the 
functionality. 

Syntax 
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void FAR PASCAL AWSReorganize 

Parameters 

None . 

Return Value 

Success — AWSError - 0 

Failure — AWSError <> 0 
AWS Set Con figuration 

This call updates the configuration information 
in the parameter file. The information can later be 
retrieved by making a call to AWSGetConf iguration . 

Syntax 

void FAR PASCAL AWSSetConf iglnf o ( iMaxBPCount, 
pszVersion, IpszLogFileName, IpszLogFilePath ) 



Parameters 



Name 


Type 


Description 


iMaxBPCount 


INT 


Maximum number of active 
business processes on the 
server . 


loszVersion 


STRING 


Vers ion number . 


lps z LocrF i 1 eName 


STRING 


Transaction loq file name. 


IpszLogFilePath 


STRING 


Path where transaction log 
file will be written. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSGetConf iguration 
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This call reads the configuration information 
from the parameter file, earlier written by calling 
AWSSetConf iglnf o . 

Syntax 

void FAR PASCAL AWSGetConf iguration ( iMaxBPCount, 
IpszVersion, IpszLogFileName, 
IpszLogFilePath ) 



Parameters 



Name 


Type 


Description 


iMaxBPCount 


INT 


Maximum number of active 
business processes on 
the server. 


IpszVersion 


STRING 


Version number. 


Ip s zLogFileN ame 


STRING 


Transaction log file 
name . 


IpszLogFilePath 


STRING 


Path where transaction 
log file will be 
written . 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 
AWSWriteToLog 

This call causes transaction information to be 
written to the workflow server log file. 

Syntax 

void FAR PASCAL AWSWriteToLog ( IpszTransInf o ) 
Parameters 
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Name 


Type 


Description 


IpszTransInf o 


STRING 


Transaction information 
to be written to loa. 



Return Value 

Success — AWSError = 0 

Failure — AWSError <> 0 

Reporter API 

Get all the BP Names 

Input Parameters : 
None 

Output Parameters : 

Array of BP Names and their versions existing in 
the database 

Get BP information using BP name 

Input Parameters : 

BP Name 
BP Version 

Output Parameters : 

BP Owner 

BP Administrator 
Primary Workflow Name 
Projected cycle time 
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Get BP Instance ids of a BP 

Input Parameters : 

BP name 
Output Parameters: 

Array of BP instance ids . 

Get Workflow Karnes of a BP 
Input Parameters : 

BP name 
Output Parameters: 

List of workflow names 

Get BP Instance data 
Input Parameters : 

BP instance id 

Output Parameters : 

BP instance status 
BP name 

Primary workflow instance id 
List of workflow instance ids. 

Get Workflow Instance Ids of a Workflow 

input Parameters : 
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Workflow name 
Output Parameters: 

List of workflow instance ids along with its BP 
instance ids. 

Get Workflow Definitional Data 

Input Parameters : 

BP name 
Workflow name 

Output Parameters : 

Workflow computed cycle time 
Workflow type 

Customer's organization role 

Performer's organization role 

Observers' organization roles 

Customer's default identity 

Performer's default identity 

Observers' default identities 

timel (Customer request cycle time) 

time2 (Performer response cycle time) 

time3 (Performer completion cycle time) 

time4 (Customer declare satisfaction cycle time) 

Conditions of satisfaction 

Get Workflow Instance Data 

Input Parameters : 

BP instance id. 
Workflow instance id. 
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Output Parameters: 

The current workflow state 
Workflow name 
Customer identity 
Performer identity 
Observer identities 
Workflow starting time 
User specified completion time 
Workflow actual completion time 
User specified cycle time of phasel 
User specified cycle time of phase2 
User specified cycle time of phase3 
User specified cycle time of phase4 
Actual cycle time of phasel 
Actual cycle time of phase2 
Actual cycle time of phase3 
Actual cycle time of phase4 

Get Workflow Summary Historical Data 

Input Parameters : 

BP name 
Workflow name 

Output Parameters: 

Average completion time of a workflow 
Best completion time of a workflow 
Worst completion time of a workflow 
Average cycle time for the customer request of a 
workflow 

Best cycle time for the customer request of a 
workflow 

Worst cycle time for the customer request of a 
workflow 
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Number of workflow instances with customer 
declare-satisfaction phase delayed 

Average delay in customer declare-satisfaction 

phase 

Maximum delay in customer declare-satisfaction 

phase 

Get Acts Taken in a Workflow instance 

Input Parameters : 

BP instance id 
Workflow instance id 

Output Parameters : 

The following details of acts taken: 
Act Taken 

Identity who took the act 
When the act was registered 
Complete by time of the act 
Respond by time of the act 
When the act was performed 

Get BP Names of a BP Collection 

Input Parameters : 

Selection criteria based oh (refer BP Collection 
query dialog box in section 6.3.1): 
BP Name 

Customer, performer and observer organizational roles 
Customer, performer and observer default identities 
Check primary/all workflow (s) flag 
Include all/latest version (s) flag 

Output Parameters : 
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Average cycle time for the performer response of 
a workflow 

Best cycle time for the performer response of a 
workflow 

Worst cycle time for the performer response of a 
workflow 

Average cycle time for the performer completion 
of a workflow 

Best cycle time for the performer completion of a 
workflow 

Worst cycle time for the performer completion of 
a workflow 

Average cycle time for the customer declare- 
satisfaction of a workflow 

Best cycle time for the customer declare- 
satisfaction of a workflow 

Worst cycle time for the customer declare- 
satisfaction of the workflow 

Total number of instances of a workflow 

Number of workflow instances which were delayed 

•Average delay of delayed workflow instances 

Maximum delay of the workflow 

Number of workflow instances which were canceled 
Number of workflow instances which were revoked 
Number of workflow instances which were declined 
Number of workflow instances with customer 

request phase delayed 

Average delay in customer request phase 
Maximum delay in customer request phase 
Number of workflow instances with performer 

response phase delayed 

Average delay in performer response phase 
Maximum delay in performer response phase 
Number of workflow instances with performer 

completion phase delayed 

Average delay in performer completion phase 
Maximum delay in performer completion phase 
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The following details of selected BPS : 
BP Name 
BP Version 
BP Owner 

BP Administrator 
Primary Workflow Name 

Get BP Instance ids of a BP 

Input Parameters : 
BP name 

Selection criteria based on (refer BP Instance 
Selection dialog box in section 6.3.5): 

From and To Dates 

Customer, performer, observer identities 
Check primary/all workflow (s) flag 

Include exceptions (Delay/Cancel/Revoke/Decline/Normal) 
flag 

Output Parameters : 

Array of BP instance ids. 

C. WORKFLOW SERVER MANAGER (WSM) 

The following is a description of the workflow 
server manager (WSM) component of the workflow system. 
The WSM uses the workflow APIs to implement the 
functions and services it provides to users. The WSM 
is a component of the workflow system that provides a 
user interface for specific services of the workflow 
server such as : 

Server Management 

Authorization Maintenance 

Business Process Maintenance 
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Workflow Maintenance 

STF Processor Maintenance 

Configuration 

Transaction Log Maintenance 

Business Process Scheduling and Organizational 
Calendar 

Through the use of the WSM, a user selects the 
scheduling function which provides the user interface 
to specify the recurrent scheduling of business 
processes as well as the specification of the 
organizational calendar as specified by the schedule 
manager. 

Workflow Server Manager classes 

The following is a description of the WSM classes 
with their attributes and methods. 

Server Management 

Server 

This class handles server management activities, 
such as server startup, shutdown, etc. Startup 
establishes a workflow server session with the 
underlying database server and starts up transaction 
manager activities. 
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Attributes 










string 


Methods 








AWSStartServer 


The method starts 
the server 
operations by 
opening a session 
with the underlying 
database server and 
starts Transaction 
Manaqer operations. 




AWSStopServer 


The method notifies 
all active users 

jiHrtiit* t"h^ cHnt" rifiun 

disconnects from 
database server, 
and shuts down rhe 
Transaction Manager 
operations . 



Authorization Maintenance 
Object 

This class provides methods to create 
objects . 



Attributes 








Obiectld 


ref(BP) or ref(WF) 




eObjectType, 


ob jecttype 
Enumerations of 
Objects are 
Business Processes 
Workflows 



Authorization 

This class provides methods to grant/revoke 
authorities to users to act on objects. 
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Attribute 
s 








TDENUser 


ref (NRDFIdentity) 




Obiect Id 


ref (Obiect) 




eAction 


actions 

Enumerations for Actions 

CLX. C 

Create 

Delete 

Modify 

Instantiate 

view 




bGrantOotion 


bool 


Methods 








AWSGrant 


The method grants 
authority to a user to 
make the specified act on 
the specified obiect. 




AWSRevoke 


The method revokes a 
previously granted 
authority form the user. 




AWS Inquire 


The method is used to 
inquire whether user has 
authority to make 
specified act on the 
specified obiect. 



Business Process Maintenance 
BPMaint 

This class provides methods to maintain business 
processes in definitions and transactions databases. 
It provides methods for archiving all completed 
business processes. 
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Methods 








AWSAbortBP 


The method aborts 
a BP instance. 




AWSDeleteBP 


The method deletes 
the specified BP 
instance from the 
transaction 
database . 




AWSSuspendBP 


The method 
suspends the 
operations of a BP 
instance 
temporarily. 




AWSResumeBP 


The method resumes 
a BP instance 
previously 
suspended. 




AWSArchiveBP 


The method 
archives a BP 
instance or all 
comDleted BPs . 




AWSListAvailBPs 


The method lists 
all BPs available 
in definitions 
database . 




AWSList Act iveBPs 


The method lists 
all BPs active in 
transactions 
database . 




AWSDeleteBPDef inition 


The method deletes 
a BP definition 
from definitions 
database . 



Workflow Maintenance 



WFMaint 

This class handles housekeeping of workflows in a 
business process. 



Methods 








AWSList Act iveWF 


The method lists all 
active workflows for 
a BP instance. 



STF Processor Maintenance 



SUBSTITUTE SHEET (RULE 26) 



WO 94/18620 



220 



PCT/US94/01287 



STFProcessor 

This class handles registration and 
deregistration of STF Processors in Names and Routing 
database . 



Methods 








AWSRegister 


The method 
registers an STF 
Processor in Names 
and Routing 
database . 




AWSDeregister 


The method 
deregisters an STF 
Processor from 
Names and Routing 
database . 



D at abas e Ma nageme nt 
DBMgmt 

This class handles various database management 
functions, such as checking a particular workflow 
server database for integrity, reindexing the 
database, and reorganizing the database. 



Methods 








AWSCheck 


The method checks 
the database for 
consistency and 
coherency . 




AWS Index 


The method 
reindexes the 
database . 




AWSReorganize 


The method 
reorganizes the 
database . 



Configuration 
Config 

This class provides methods to set and inquire 
various configurable parameters . 
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Attributes 








iMaxOpenBPs 


int 










IpszLocrFileName 


strina 




loszLooFilePath 


strina 


Methods 


AWSSetConf iguration 


The method set the 
configuration 
parameters to 
specified value. 




AWSGetConf iguration 


The method 
retrieves 
configuration 
parameters from 
the file. 



Transaction Log Maintenance 
TransLog 

This class provides methods to maintain 
transaction log. The workflow processor uses this 
method to write all changes in the workflow status to 
the log. 



Methods 








AWSWriteToLog 


The method writes 
the specified 
string to the 
transaction loa . 
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CLAIMS 

1. A system for managing business 
processes, each business process including a 
plurality of linked workflows, by providing 
services to workflow enabled applications that 

5 allow users to act and participate in said 
business processes comprising: 

a) workflow server means for providing: 
i) transaction services for 

.1. initiating the workflows; 
10 2. taking actions in initiated 

workflows; 

3. updating and maintaining 
workflow status after each 
act is taken in a 

15 predetermined one of said 

initiated workflows and 
keeping track of pending 
workflow activities; 

4 . producing reports specifying 
20 available business processes 

that a predetermined one of 
said workflow enabled 
applications can initiate; 

b) database means for storing records of 
25 workflow transactions. 

2. A system for managing business 
processes, each business process including a 
plurality of linked workflows, by providing 
services that allow designers to analyze and 

5 design business processes and applications 
comprising : 

a) workflow server means for providing: 
i) definitions services for: 

1 . defining elements of a 
10 business process, its 
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workflows and workflow 
links; 

2. defining structures for the 
workflows of the business 
15 process; 

ii) names and routing services for: 

1. defining roles associated 
with the workflows; 

2. defining identities 

20 associated with defined 

roles ; 

b) database means for storing records of: 

i) definitions of an organization, 
business processes of the 

25 organization, workflows of the 

business processes, roles and 
acts associated with the 
workflows; 

ii) the roles and identities of users 
30 within an organization utilizing 

the workflow system. 

3. A system for managing business 
processes, each business process including a 
plurality of linked workflows, by providing 
services to workflow enabled applications that 
5 enable managers to observe and query the status 
of said workflows and business processes 
comprising : 

a) workflow server means for providing: 
i) transaction services for 
10 1. initiating the workflows; 

2. taking actions in initiated 
workflows; 

3. updating and maintaining 
workflow status after each 

15 act is taken in a 
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predetermined one of said 
initiated workflow; 
4 . producing lists of workflows 
with pending actions; 

20 5. producing reports specifying 

available business processes 
that a predetermined one of 
said workflow enabled 
applications can initiate; 

25 b) database means for storing records of : 

i) definitions of an organization, 
business processes of the 
organization, workflows of the 
business processes, roles and 

30 acts associated with the 

workflows; 

ii) workflow transactions; 

iii) the roles and identities of 
customers, perfomers and 

35 observers utilizing the workflow 

system. 

4. The system defined by Claim 1 wherein 
said workflow server means provides transaction 
services for producing lists of workflows with 
pending actions. 

5. The system defined by Claim 1 wherein 
said database means is for storing records of the 
date and time when a business process must be 
initiated. 

6. The system defined by Claim 1 wherein 
said database means is for storing configuration 
information used by the workflow server means . 

7. The system defined by Claim 1 wherein 
said database means is for storing notifications 
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to be sent to users that interact with the 
workflow system through a standard transaction 
5 format processor interface. 

8. The system defined by Claim 1 further 
comprising application program interface means 
for providing an interface to the server means to 
enable workflow enabled applications to obtain 

5 access to the services provided by the server 
means . 

9. The system defined by Claim 1 wherein 
said workflow server means provides transaction 
services for binding application specific data to 
a workflow transaction. 

10 The system defined by Claim 1 wherein 
said workflow server means provides definitions 
services for defining elements of a business 
process, its workflows and workflow links. 

11. The system defined by Claim 1 wherein 
said workflow server means provides definitions 
services for defining structures for the 
workflows of a business process. 

12. The system defined by Claim 1 wherein 
said workflow server means provides names and 
routing services for defining roles and defining 
identities . 

13. The system defined by Claim 1 wherein 
said workflow server means provides configuration 
services for defining a network configuration of 
the workflow system, the version of the server 

5 means, registering standard transaction format 
processors, defining users f specifying a log 
database and a level of logging required. 
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14. The system defined by Claim 1 wherein 
said workflow server means provides scheduling 
services for allowing an authorized user to 
create, modify and delete records of scheduled 

5 business processes. 

15. The system defined by Claim 1 further 
comprising means for updating the workflow server 
databases as an interface to the server means to 
enable workflow enabled applications to obtain 

5 access to services provided by the server means . 
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Fig. 4a 
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